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PREFACE 


This manual assumes the user has read an introductory book on assembly 
language. It is not intended to teach assembly language. Suggested references 
for assembly language beginners are 6502 Assembly Language Programming by 
Lance Leventhal and Programming the 6502 by Rodney Zaks (see Appendix 8). 

The user should also know how to use the screen editing and control features of 
the ATARI® 400™ and ATARI 800™ Personal Computer Systems. These 
features are the same as used in ATARI BASIC. Review the ATARI BASIC 
Reference Manual if you are unsure of how to do screen editing. 

This manual Starts by showing the structure of Statements in assembly 
language. The manual then illustrates the different types of 6502 operands. The 
Assembler Editor cartridge contains three separate programs: 

• EDIT (Editor program) — Hclps you put programming Statements in a form 
the Assembler (ASM) program understands. The EDIT program lets you use 
a printer to print a listing of your program. Programs can also be stored and 
recalled using ENTER, LIST and SAVE, LOAD. The Assembler Editor allows 
automatic numbering, renumbering, delete, find and replace. 

• ASM (Assembler program) — Takes the program Statements you create in 
the EDIT step and converts to machine code. 

• DEBUGGER — Helps you trace through the program steps by running the 
program a step at a time while displaying the contents of important internal 
6502 registers. The DEBUGGER program also contains programming 
routines which allow you to display registers, change register contents, 
display memory, change memory contents, move memory, verify memory, 
list memory with disassembly, assemble one instruction into memory, go 
(execute program), exit. The disassembly routine is especially useful in 
reading and understanding machine language code. 

The Assembler Editor cartridge allows you to talk in the computer’s natural 
language — machine language. Assembly language programming offers you 
faster running programs and the ability to tailor programs to your exact needs. 
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ABOUT THIS 
MANUAL 


ATARI 

PERSONAL 

COMPUTER 

SYSTEMS 


INTRODU CTION 


To use (he ATARI® Assembler Editor cartridge effectively, there are four 
kinds ol Information that you must have. First, you need some guidance about 
how to use the cartridge itself. Second, you need to know about the ATARI 
Personal Computer System you are using with the cartridge. Third, you need to 
know something about 6502 Assembly Language programming. And, fourth, 
the Assembler Editor Cartridge was designed to be used with the ATARI disk 
drives and DOS II. 


I his manual explains the Operation ofthe ATARI Assembler Editor cartridge. It 
does not explain 6502 Assembly Language programming. If you are already 
familiär with 6502 Assembly Language, you will find this manual amply suited 
to your needs; otherwise, you should refer to one of the many books that ex¬ 
plain 6502 Assembly Language programming; suitable books are listed in 
Appendix 8. 

If you are familiär with ATARI BASIC and have written some programs on your 
ATARI 400 IM or ATARI 800™ Personal Computer System, you will find no 
better way to learn assembly language than the combination of this manual, the 
ATARI Assembler Editor cartridge, and a 6502 programming book. 

If you have had no experience with Computers and no programming exper- 
ience, then this manual is probably too advanced for you and you should Start 
by writing some programs using ATARI BASIC and your ATARI Personal Com¬ 
puter System to bccome familiär with programming in general. Reading one of 
the books recommended in Appendix 8 will help you learn assembly language. 


The ATARI Assembler Editor cartridge is installed in the cartridge slot of the 
ATARI 400 Computer console and in the left cartridge slot of the ATARI 800 
Computer console. You must be familiär with the keyboard and all the screen- 
editing functions. That material is covered in the appropriate Operator’s Manual 
supplied with your ATARI Personal Computer System. The special screen- 
editing keys are described in Section 6 ofthe Operator’s Manual. You should 
read Section 6 and follow the instructions until you are completelv familiär with 
the keyboard and the screen-editing functions. 

You need not have any equipment except the ATARI Personal Computer System 
console, your television or a video monitor for display, and the ATARI 
Assembler Editor cartridge. However, without a permanent storage device you 
will have to enter your program on the keyboard each time you wish to use it. 
This can be tedious and time-consuming. An ATARI 410™ Program Recorder, 
ATARI 810™ Disk Drive, or ATARI 815™ Dual Disk Drive (double density) is a 
practical necessity. 
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The ATARI 410 Program Recorder is an accessory that functions with the 
ATARI 400 and the ATARI 800 Personal Computer Systems. The proper Opera¬ 
tion of your Program Recorder is explained in Section 8 of the ATARI 400 and 
ATARI 800 Operator’s Manuals. Before using the Program Recorder with the 
Assembler Editor cartridge, be sure you know how to operate the Program 
Recorder. The disk drives are accessories that function with any ATARI Per¬ 
sonal Computer System with at least 16K RAM. To use a disk drive you need a 
special program, the Disk Operating System (DOS). At least 16K of memory is 
required to accommodate DOS. Consequently, if you are using an ATARI 400 
Personal Computer System, you must Upgrade it from 8K to 16K (RAM). This can 
be done at any ATARI Service Center. 


If you are using the ATARI 810 Disk Drive, you should refer to the instructions 
that come with it. You should also read the appropriate Disk Operating System 
Reference Manual. If you are currently using the 9/24/79 Version of DOS (DOS I), 
you must use the program in Appendix 11 for the disk drive to be compatible 
with the Assembler Editor cartridge. 

If you are using the ATARI 815 Dual Disk Drive, you should refer to the ATARI 
815 Operator’s Manual and the Disk Operating System II Reference Manual that 
come with it. 


You can also add the ATARI 820™, the ATARI 825™ or the ATARI 822™ Printer 
to your Personal Computer System to give you “hard copv”—that is, a perma¬ 
nent record of your program written on paper. 


HOW AN 
ASSEMBLER 
EDITOR IS USED 


All assembly language programs are divided into two parts: a “source 
program,” which is a human-readable Version of the program, and the “object 
program,” which is the computer-readable Version of the program. These two 
versions of the program are distinct and must occupy different areas of RAM. 
As the programmer, you have three primary tasks: 


• To enter your source program into the Computer, edit it (make insertions, 
deletions, and corrections) and save it to or retrieve it from diskette or 
cassette. 

• To translate your source code into object code. 

• To monitor and debug the Operation of your object program. 


These three tasks are handled with three programs included in the ATARI 
Assembler Editor. The first program, called the Editor, provides many handy 
features for entering the program and making insertions, deletions, and correc¬ 
tions to it. It also allows you to save and retrieve yoiar source code. The second 
program, called the Assembler, will translate your source program into an 
object program. While doing so, it will provide you with an “assembly listing,” 
a useful listing in which your source program is lined up side by side with the 
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resulting object program. The third program is called the Debugger; it helps 
you to monitor and debug your object program. The relationship between these 
three programs is depicted as follows: 


-YOU 


Editor 

Source Program 



Figure 1. Relationship of various parts of Assembler Editor Cartridge 

to you and your Software. 


In Section 3 we explain the Editor; in Section 4, the Assembler; and in Section 5, 
the Debugger. There are some fundamental ideas wc must explain first. 
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NOTES: 


4 Notes 
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GETTING 

STARTED 


ALLOCATING 

MEMORY 


The very first decision you must make when you sit down to write your source 
program involves the allocation of memory space. 

All programs, regardless of language, occupy memory space. The Computer has 
a limited amount of memory and must manage its memory carefully, allocating 
portions of memory for program, data, display space, and so forth. This is all 
done automatically in BASIC, so the BASIC user need not worry about where in 
memory his program and data are stored. Such is not cjuite the case with the 
Assembler Editor cartridge. You have the power to place your programs 
anywhere in memory that you desire. With this power comes the responsibility 
to allocate memory wisely. 

The ATARI Computer System uses low memory for its own internal needs. The 
amount it uses depends on whether or not DOS is loaded into RAM. In any 
event, the Assembler Editor cartridge will automatically place your source pro- 
gram into the chunk of memory starting with the first free memory location. 
As you type in more source code, the memory allocated to storing your source 
code (called the Edit Text Buffer ”) grows. If you delete lines of source code, the 
edit text buffer shrinks. You can visualize the memory allocation with this 
figure, which is called a memory map: 


OS 

RAM 

h 


DOS 

RAM 


-A 

3 

180 Edit Text 

Empty 

Bytes Buffer , 

Memory 

H i 


-*4* 



I—C 

Display 
RAM 

Top Of 
Your RAM 


c 


Bottom of 
Usable RAM 


*not to scale 


Top of 
Addressable 
Memory 


Figure 2. Memory map without use ofLOMEN. 


The edit text buffer always grows towards the right, into the “empty memory” 
area. The left side of the edit text buffer is fixed in place once you Start entering 
code. 

Your problem is to determine where to störe the object code produced by the 
Assembler. If you put the object code into the regions marked OS RAM, DOS 
RAM, or display RAM, you will probably cause the Computer to crash and all 
your typing will be lost. If you put it into the place called the edit text buffer, 
the object code will overwrite the source code, causing more chaos. The only 
safe place to put your object code is in the “empty memory” area. 
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You can find out where this empty memory area is by typing SIZE Hg . 
Three hexadecimal numbers will be displayed, like so: 

SIZE £ 

0700 0880 5C1F 
EDIT 


The first number (0700 in this example) is the address of the bottom of usable 
RAM, the point labeled ‘"A” on the memory map. The second number is the 
address of the top of the edit text buffer, labeled “B” on the memory map. The 
third number is the address of the top of empty memory, labeled “C” on the 
memory map. The difference between the second and third numbers (how 
good are you at hexadecimal subtraction?) is the amount of empty memory. You 
can use the SIZE command any time you desire to know how much empty 
memory remains. 


Liberally estimate the amount of memory your object program will require, 
then subtract that amount from the third number. For extra insurance, round 
the result down. For example, if you thought that your object code might 
require 1.5K, you’d subtract 2K from $5C1F to get $541F and then for simplicity 
(and additional insurance) you would round all the way down to $5000. You 
would therefore störe your object code at $5000, confident that it would not 
encroach on the display memory. More conservative estimates and greater care 
would be necessary if memory were in short supply. 


Having decided to störe the object program starting at address $5000, your next 
task is to declare this to the Computer. This is done with * = directive. The very 
first Statement of the source code would read: 

10 *=$5000 


This directive teils the Assembler to put all subsequent object code into memory 
starting at address $5000. Although it is not absolutely necessary, it is always 
wise practice to make the * = directive the very first line of your source 
program. 


You have two other strategies for allocating memory space for your object 
program. The first and simplest strategy is to place your object code on page 6 of 
memory. The 256 locations on page 6 have been set aside for your use. If your 
object program and its data will all fit into 256 bytes, then you can put it there 
with the directive: 

10 *=$0600 


This is a good safe way to Start when you are still learning assembly language 
programming and are writing only very short programs. As your programs 
grow larger, you will want to move them off page 6 and use page 6 for data and 
tables. 


The second strategy is to bump the edit text buffer (your source program) up- 
ward in memory, leaving some empty memory space below it. You can then 
place your object code into this empty space. Figure 3 shows the adjustment of 
the memory map. 
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Empty 

Memory 


Bottom of 
Usable RAM 


Top of 
Your RAM 


Top of 
Addressable 
Memory 


Figurc 3. Memory map with use ofLOMEM. 


This bumping is accomplished with a special command called LOMEM. The 
command is special because it must be the very first command you enter alter 
turning on the Computer. Its form is simple: 

LOMEM XXXX 


where XXXX is the hexadecimal address of the new bottom edge of the edit text 
buffer (point A in the memory map). You must not set LOMEM to a smaller 
value than it normally is, or you will overwrite OS data or DOS and crash the 
System. Furthermore, if you set LOMEM too high, you will have too little room 
for your source program. You must estimate how much memory your object 
code will require, and bump the edit text buffer upward by that much plus 
some more for insurance. Then your first program instruction becomes: 

10 * =$YYYY 


where YYYY is the old value of A given by the SIZE command before you 
turned off the Computer, turned it back on, and used the LOMEM command. 

You might wonder why anybody would want to use the LOMEM command and 
störe the object program in front of the source program instead of behind it. 
The primary reason this command is provided comes from the fact that the 
Assembler program, as it translates your source program into an object pro¬ 
gram, uses some additional memory (called a Symbol table) just above the edit 
text buffer. If you really wantcd to, you could figure just how much memory 
the Symbol table uses; it is three bytes for each distinct label plus one byte for 
each character in each label. Most programmers who don’t enjoy figuring out 
how big this Symbol table is use the LOMEM command so they won’t have to 
worry about it. (Only the label itself counts, not the number of times it appears 
in the program.) 

Allocating memory can be a confusing task for the beginncr. Only two instruc- 
tions (LOMEM and *=) are used, but if they are misused you can crash the 
System and lose your work. Fortunately, if you restrict yourself to small pro- 
grams initially youTl have plenty of empty memory space and fewer allocation 
Problems. 

The * = directive will be followed by your source program. The source program 
is composed of Statements. The Statements must be written according to a 
rigorous format. The rules for writing Statements are given in the next section. 
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PROGRAM 
FORMAT—HOW 
TO WRITE A 
STATEMENT 


A source program consists of Statements. Each Statement is terminated vvith 
HCflllll- A Statement may be 1-106 characters long, or almost three lines on the 
screen. A Statement is also called a line. The distinction is made between a 
physical line (a line on the screen) and a logical line (the string of characters, up 
to three physical lines between 8TCTi!gl s). 


A Statement can have up to tive parts or “fields”: the Statement number, a label, 
the Operation Code mnemonic or directive, an Operand, and a comment. These 
five fields occupy successive positions in the Statement, with the Statement 
number coming first and the comment coming last. Fields are separated 
(“delimited”) by single spaces. 


Statement Number 

Every Statement must start with a number from 0 to 65535. It is customary to 
number Statements in increments of 10, 20, 30, etc. The Editor automatically 
puts the Statements in numerical Order for you. Numbering by tens allows you 
to insert new Statements at a later date between existing Statements. To assist 
you, the Editor has several convenient commands for automatically numbering 
Statements (see NUM, REN). 


Label 

A label, if used, occupies the second field in the Statement. You must leave 
exactly one space (not a tab) after the Statement number. The label must start 
with a letter and contain only letters and numbers. It can be as short as one 
character and as long as the limitation of Statement length permits (106 less the 
number of characters in the Statement number). Most programmers use labels 
three to six characters long. 

You are not forced to have a label. To go on to the next field, enter another space 
(or a tab). The Assembler will interpret the entries after a tab as an Operation 
code mnemonic. 


Operation Code Mnemonic 

The Operation code (or op code) mnemonic must be one of those given in 
Appendix 2. It must be entered in the field that Starts at least two spaces after 
the Statement number, or one space after a label. An Operation code mnemonic 
in the wrong field will not be identified as an error in the Edit mode, but will be 
flagged when you assemble the program (Error 6). 


Operand 

The field of the Operand Starts at least one space (or a tab) after an Operation code 
mnemonic. Some Operation code mnemonics do not require an Operand. The 
Assembler will expect an Operand if the op code mnemonic requires one. Each 
different way of writing an Operand is given in the section called HOW TO 
WRITE OPERANDS. 


Comment 

A comment appears on the listing of a program, but does not in any way affect 
the assembled object code. Programmers use comments to explain to others (and 
to themselves) how a section of code works. 
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There are two ways to have the Assembler interpret entries as comments. One 
way is to make the entries in the comment field, which occupies the remainder 
of the line after the instruction field(s). At least one space must separate the 
instruction fields from the comment field. There may not be enough space in 
the comment field for the comment you wish to write there. In that case it is 
best to use one or more lines as comment lines dedicated only to making com¬ 
ments and containing no code. To do so, you enter one space and a semicolon 
followed by any comment or explanatory markings you desire. Everything 
between the initial semicolon and the |g |§| is ignored by the Assembler, but 
will be printed in the listing of the program. 


A sample programming form for assembly language is reproduced as Figure 4. 
The form shows examples of how to enter line number, label, op code, Operand 
and comments. These classes of entry are lined up vertically on the program¬ 
ming form. Most Variation occurs in the method of entering a comment. 
Therefore, Figure 4 includes examples of the various ways to enter comments. 


Sample, Reproducible 
ATARI Programming Form 


PROGRAM . 
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PAGE OF DATE Ä _ , 
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Figure 4. Example ofhow to yvrite Line No., Label, Op Code,Operand, 
and Label on the Atari programming form. 
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The spacing on the programming form is not the same as the spacing to be used 
on the screen, controlled by keyboard entry. On the screen the classes of entry 
(the tields) are not lined up vertically. The screen has 38 positions (you can 
change it to a maximum of 40), fewer than the programming form, and that is 
the main reason not to use many spaces between fields. Another difference be- 
tween the programming form and screen is the ‘wraparound’ on the 
screen—automatic continuation of characters onto the next line. 

Figure 5 shows the entries in Figure 4 as they should appear on the screen when 
entered on the keyboard with the recommended spacing. In general, the spac¬ 
ing recommended in this manual is the minimum spacing that will be correctly 
in'terpreted by the Assembler Editor. If you prefer to have more vertical align- 
ment of tields, use TAB, rather than the single spacing between tields that we 
recommend. The Statements below show various examples of comments cor¬ 
rectly positioned in the Statement. Bach comment in the examples Starts with 
“COMMENT” or semicolon(;). 



Figure 5. Statements as they would appear on the screen when entered 
on the keyboard with the recommended spacing. The various 
ways to enter comments are illustrated. Compare with Figure 4. 



HOW TO WRITE This section shows how to write operands. The examples use Statement number 
OPERANDS xxxx (also called line number XXXX). An instruction entered without a State¬ 

ment number is not allowed by the Editor. 

The examples use BY (for byte) and ABS (for absolute) as a one-byte and a two- 
byte number, rcspectivcly. This use implies that the program includes defini- 
tions of BY and ABS as, for example: 

0100 BY = 155 
0200 ABS = 567 

Please refer to the description of the LABE = directive for an explanation of the 
definitions of lines 100 and 200. 


Hexadecimal Operands 

A number is interpreted as a decimal number unless it is preceded by $, in 
which case it is interpreted as a hexadecimal number. 

Examples: 

30 STA $9325 
80 ASL $15 

Immediate Operands 

An immediate Operand is an Operand that contains the data of the instruction. 
The pound sign (#) must be present to indicate an immediate Operand. 

Examples: 

40 LDA #12 
70 ORA #$3C 
1000 CPY #BY 

Page Zero Operands 

When an Operand is a number less than 255 decimal, (FF hex) and is not 
immediate, the number is interpreted as a page zero address. 


Examples: 

150 LDX $12 
250 ROR 33 
500 DEC BY 

Absolute Operands 

Absolute operands are evaluated as 16-bit numbers. 


Examples: 

20 LDX $1212 
40 CPY 2345 
990 DEC 579 
2350 BIT ABS 


Absolute Indexed Operands 

An absolute indexed Operand uses register X or Y. The Operand is written 
_,X or_,Y 
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Examples: 

10 AND $3C26,X 
110 EOR 20955,Y 
1110 STA ABS,Y 

Non-Indexed Indirect Operands 

In general, an indirect Operand is written with parentheses. The address within 
the parentheses is an intermediate address vvhich itself contains the effective 
address. The only instruction with a non-indexed indirect Operand is Jump In¬ 
direct. The Operand is a number enclosed in parentheses. The parentheses in the 
Operand enclose a number or an expression that is interpreted as an inter¬ 
mediate address. 

Examples: 

JMP ($6000) 

JMP (ABS) 

JMP (7430) 

JMP (ABS + 256*BY) 

Indexed Indirect Operands 

An indexed indirect instruction uses register X. The Operand is written (—,X) 
Examples: 

10 INC ($99,X) 

Indirect Indexed Operands 

An indirect indexed instruction uses register Y. The Operand is written (—),Y 

Examples: 

10 LDA ($2B),Y 
110 CMP ($E5),Y 
1110 ORA (BY),Y 

Indexed Page Zero Operands 

A zero page indexed Operand is written —,X or —,Y 

Examples: 

10 INC $34,X 
110 STX $AB,Y 
1110 LDX BY,Y 

String Operands 

Operands or parts of operands enclosed in double quotation marks are 
translated into the ATASCII codes of the characters between the quotation 
marks. The use of such operands must of course be appropriate to the type of 
instruction or directive to which they are appended. 

Examples: 

10 ADDR .BYTE “9 + 1 =s TEN” 

Execution of this directive causes the ATASCII numbers corresponding to “9”, 
“ + ”, etc., to be stored at successive locations starting at ADDR. Note that the 
ATASCII representation of any character except the quotation mark (”) can be 
stored with the .BYTE directive having a string Operand. 



Exhibit I 


Sample, Reproducible 
ATARI Programming Form 
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COMMANDS TO 
EDIT A 
PROGRAM 


USING 
THE EDITOR 


Nuw that we havc explained how to gct started writing a program, it is up to 
you to actually writc the program. This manual contains very little Information 
on assembly languagc programming techniques. Wc assume that you are 
alrcady familiär with assembly language. The remainder of the section 
describes how to use the Assembler Editor cartridge. 


A command is not the same thing as an instruction. An instruction has a line 
number; a command has no line number and is executed immediately. 


NEW Command 

This command clears the edit text buffer. After this command you cannot 
restore your source program; it has been destroyed. 

Sonic programmers have the habit of giving the NEW command (or its 
equivalent with other assemblers) whcn they start a programming session. The 
reason is to remove any “garbage” that may be in mernory by mistake. Since 
the ATARI Personal Computer System clears its mernory when it is turned on, 
such routine use of NEW would be a needlcss precaution. Because NEW destroys 
your entire source program, it is more important to develop a habit of NOT 
using it routinely. You should, rather, use NEW in a very dcliberate fashion only 
when you want to remove a source program from RAM. 


DEL Command 

This command deletes Statements from your source program. 


DELxx 

DELxx,yy 


RETURN 




deletes Statement number xx. 

deletes Statement numbers xx through yy. 


NUM Command 

This command assigns Statement numbers automatically. 


NUM 


increments Statement number by 10 
after each The new Statement 

number, followed by a space, is auto¬ 
matically displayed. 

NUMnn 

ÜO 

has the same effect as NUM, but the 
increment is nn instead of 10. 

NUMmm,nn 


forces the next Statement number to be 
mm and the increment to be nn. 

mm 

mm 

cancels the NUM command. 
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The effect of the NUM command stops automatically when a Statement number 
that already exists is reached. For example: 

10 LDX #$EF 
20 CMP MEMORY 
NUM 15,5 
15 

After Statement number 15, the next Statement number would be 20, whicb 
already exists, so the NUM command is cancelled. The automatic numbering of 
Statements will continue until the next number is exactly ecjual to an existing 
number. A slight change from the above example illustrates this: 

10 LDX #$EF 

20 CMP MEMORY 
NUM 15,6 

15 TAX 

21 

Caution: You cannot use the special keyboard editing keys to change other 
Statements while the NUM command is in effect. You will succeed in changing 
what appears on the screen, but, in an exception to the general rule, the Con¬ 
tents of the edit text buffer will not be changed. 

REN Command 

This command renumbers statements in your source program. 

REN renumbers all the Statements in 

increments of 10, starting with 10. 

RENnn renumbers all the statements in 

increments of nn, starting with 10. 

RENmm nn S112S renumbers all the statements in 

increments of nn, starting with mm. 

FIND Command 

This command finds a specified string. The ways to write the command are 
shown below. 

FIND/SOUGHT/ SS fmds the first occurrence of the string 

SOUGHT. The Statement that contains 
the string is displayed. 

FIND/SOUGHT/,A @Q&g| fmds all occurrences of the string 

SOUGHT. All statements containing such 
occurrences are displayed. 

FIND/SOUGHT/xx füS fmds the string SOUGHT if it occurs in 

Statement number xx. Statement xx is 
displayed if it contains the string. 

FIND/SOUGHT/xx,yy,A fmds all occurrences of the string 

SOUGHT between Statement number xx 
and yy. All the statements that contain 
the string are displayed. 


l(j Using the Editor 








In these examples, the string SOUGHT is delimited (marked off) by the 
character /. Actually, any character except space, tab and ffiäfsSI can be used as 
the delimiter. For example, the cominand 

FIND DAD 

finds the first occurrence of the character A. The delimiter is the character D. 
The delimiter is defined as the first character (not counting space or tab) after 
the keyword FIND. This feature is perplexing to beginners; its purpose is to 
allow you to search for strings that contain slashes (/) or, for that matter, any 
special characters. 

The general form of the command is 

FIND delimiter string delimiter [lineno, lineno] [,A] 

In the general form, Symbols within a pair of brackets are optional qualifiers of 
the command. 


REP Command 

This command replaces a specified string in your source program with a dif¬ 
ferent specified string. 

REP/OLD/NEW fffHügi replaces the first occurrence of the string 

OLD with the string NEW. 

REP/OLD/NEW/xx,yy üHKfflSS replaces the first occurrence of the string 

OLD between Statements number xx to 
yy with the string NEW. 

REP/OLD/NEW/,A üSlül replaces all the occurrences of the string 

OLD with the string NEW. 

REP/OLD/NEW/xx,yy,A replaces all the occurrences of the string 

OLD between Statements xx to yy with 
the string NEW. 

REP/OLD/NEW/xx,yy,Q. üMM displays, in turn, each occurrence of the 

string OLD between Statements xx and 

yy- 

Q Stands for “query.” To replace the 
displayed OLD with NEW, type Y, then 
To retain the displayed OLD, 
press 8iTS8Sigi . 

In these examples, the strings OLD and NEW are delimited by the character 
As with the FIND command, any character except space, tab and RETURN, can 
be used as the delimiter. For example, the command 

REP + RTS + BRK + ,A 

replaces all occurrences of RTS with BRK. The delimiter is the character “ + ”. 


The general form of this command is 

REP delimiter OLD delimiter NEW delimiter [lineno, lineno] L,A J 

In the general form, symbols within a pair of brackets are optional qualifiers of 
the command and the symbols within braces (A and Q) are alternatives. 
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Sample Program 

Let us assume you have written a program on an ATARI Programming Form as 
shown in Figure 6: 

Exhibll I Sample, Rcproduclble 

ATARI Programming Form 
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Figure 6. Sample Program as you write it on the 
A TAR1 programming form 


Then when you type it in it would appear on the screen as shown in Figure 7 



Figure 7. Appearance of the screen as your program is 
entered on the keyboard. 




COMMANDS TO 
SAVE (OR 
DISPLAY) AND 
RETRIEVE 
PROGRAMS 


The commands to save (or display) and retrieve programs are: 


LIST saves or displays a source program 
PRINT is the same as LIST, but omits line numbers 
ENTER retrieves a source program 
SAVE saves an object program 
LOAD retrieves an object program 

With each of these commands there is a parameter that specifies the device that 
is the source or destination of the program that is to be saved, displayed or 
retrieved. The possible devices are different for different commands, and the 
default device is also different. Some of the commands have optional parameters 
that limit the application of the command to specified parts of the program. 

The parameter that specifies the device that is the source or destination of the 
program is written as follows: 


#E: 


is the screen editor 


ttV 


is the printer 


ffC: 

#D[n]:FILENAME 


is the Program Recorder 
is a disk drive. 

n is 1, 2, 3 or 4. D: is interpreted as Dl:. 

A program saved on or retrieved from a diskette must be 
named (FILENAME). 


LIST Command 


Format: 

Examples: 


LIST# 


device: 

filespec 


[,xx,yy] 


LIST#E: 


LIST#D:MYFILE 


This command is used to display or save a source program. The device where 
the source program is to be displayed or saved is given in the command. If no 
device is specified, the screen is assumed by default. Other possible devices are 
the printer (#P:), Program Recorder (#C:) and disk drive (#D1: through #D8: or 
#D:, which defaults to #D1:). The commands to transfer a program (LIST it) to 
these various devices are: 


LIST#E: (LIST#E: is the same as LIST) 

LIST#P: 

LIST#C: (Use cassette-handling procedures described in your Pro¬ 

gram Recorder Operator’s Manual.) 

LIST#D:filename where filename is an arbitrary name you give to the 

program. Filename must Start with a letter and have no 
more than eight characters, consisting of letters and 
numbers only. It may also have an extension of up to 
three characters. For example, NAME3, ST5, and 
JOHN.23 are all legal names. 
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The forms of the commands to transfer only particular lines (lines xx to yy) to a 
device are: 

LIST#E:,xx,yy (LIST#E:,xx,yy is the same as LIST,xx,yy) 

LIST#P:,xx,yy 

LIST#C:,xx,yy (Use cassette-handling procedures described in the 

Program Recorder Operator’s Manual.) 
LIST#D:NAME,xx,yy where “NAME” is an arbitrary name you give to the 
program. See the description above. 

A single line may be displayed or saved with the command: 

LISTlineno where lineno is the line number. 


Caution: The DOS makes sure that every file has a unique name by deleting old 
flies if necessary. Therefore, do not name a file you are listing to diskette with 
the name of a file that is already stored on the diskette, unless you wish to 
replace the existing file with the one you are listing. 


The LIST command is illustrated below. No device is specified, so the display 
device is the screen, by default. The small sample program, written in the 
previous section, is used for illustration. 


EDIT 

LISTEUSa 


10 

20 

30 

40 

50 

G0 

70 

80 

90 


*=$3000 
LDY #00 

REP LDX, ABSX, Y 
BNE XEQ SAME PAGE 
INY TALLY 


JMP REP 
ABSX = $3744 
XEQ, = *+$60 
.END 


EDIT 

LIST30 


RETURN 


30 REP LDX ABSX, Y 
EDIT 

LIST 60,80 Mil 


60 JMP REP 
70 ABSX = $3744 
80 XEQ=*+$60 

EDIT 

□ 


The examples above show the appearance of the screen, since that is the default 
device. The program or the particular lines in the examples could be displayed 
on the printer or saved on cassette or diskette by using the forms of the LIST 
command described above. Note that the commands tolerate a certain amount 
of Variation in the insertion of blanks. 
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PRINT Command 


This command is the same as LIST, except that it prints Statements without 
Statement numbers. 


Example: 

EDIT 


RETURN 


*=$3000 

ldy #oo 

REP LDX ABSX, Y 

BNE XEQ SAME PAGE 

INY TALLY 

JMP REP 

ABSX = $3744 

XEQ=*+$60 

.END 


EDIT 

PRINT30 


RETURN 


REP LDX ABSX, Y 


RETURN 


EDIT 

PRINT 60,80 HSTOiHlI 

JMP REP 
ABSX = $3744 
XEQ,= *+$60 


RETURN 


EDIT 

D 


After using a PRINT 
press iittfliiTCl . which 


command, no further command can be entered until 
causes the EDIT message and Cursor to be displayed. 


you 


ENTER Command 


Format: 


ENTER# 


device: 

filespec 


Examples: ENTER#C: 

ENTER#D:MYFILE 


The command ENTER is used to retrieve a source program. As with the com¬ 
mand LIST, a device has to be specitied, in this case the device where the pi'o- 
gram is stored. There is only one device, the disk drive, on which a named pro- 
gi am is stored in a retrievable form. To retrieve a source program from a 
diskette in a disk drive, the command is: 

ENTER#D:NAME 


Using tlw Editor 21 


where “NAME” is the arbitrary name you gave to the program when you listed 
it on the diskette. This command clears the edit text buffer before transferring 
data from the diskette. 

To retrieve a source program from cassette, the command is: 

ENTERIC: (Kollow the CLOAD procedure given in your 410 Pro¬ 

gram Recorder Operator’s Manual.) Note that ENTER ffC: 
clears the edit textbuffer before retricving the 
source program. 

To merge a source program on cassette with the source program in the edit text 
buffer, the command is: 

ENTERIC:,M 

In the above command, where a Statement number is used twice (in the edit text 
buffer and on tape), the Statement on cassette prevails. 

Commands for saving and retricving an object program are SAVE and LOAD. 
They correspond to LIST and ENTER, respectively. 


SAVE Command 

Format: SAVE# ^Uespec^j < addressl,address2 

Examples: SAVE#C: < 1235,1736 

SAVE#D2:MYFILE< 1235,1736 




To save an object program residing in hex addressl to address2 on cassette 
or diskette, the commands are: 

SAVE#C: < addressl, address2 

CAUTION: Use the CSAVE procedure illustratcd in your 410 Program 
Recorder Operator’s Manual. 


SAVE#D:FILENAME < addressl, address2 

where FILENAME is an arbitrary name you give to the block of 
memory that you are saving (where your object program is 
stored). 


LOAD Command 


device: 

Format: LOAD# 

filespec 

Examples: LOAD#C: 

LOAD#D:MYFILE 


22 Usirig the Editor 



To retrieve an objcct program that had previously been SAVED and which had 
previously been called NAME, the command is: 

LOAD#D:NAME where NAME is the arbitrary name that you gave to the 
object program when you saved it on diskette. 

LOAD#C: (Use the CLOAD procedure described in your 410 Pro¬ 

gram Recorder Operator’s Manual.) 

These commands will reload the memory locations addressl to address2 with 
the contents that were previously saved. The numbers addressl and address2 
are those that were given in the original SAVE command. 
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USING 
THE ASSEMBLER 


THE ASM 
COMMAND 


The general form of the ASSEMBLE command is 


| ASM#[#D[n]:PROGNAME[.SRC]] | 


M#P:l 

|L,S#D[n]:LISTING[.LST)iJ | 


| [,#D[nl:SEMBLED[.OBJ]l | 


Where source program 
is located 


Where object program 
is to be stored 


Where assembiy listing 
is to be stored or displayed 


The default values of the three parameters of the ASM command are the edit 
text buffer for the source program, the television screen for the assembiy 
listing, and Computer RAM for the object program (the assembled program). To 
assemble a program using default values of ASM, type 


RETURN 


On receiving this command, the Assembler translates the source program in the 
edit text buffer into object code and writes the object code into the memory loca- 
tions specifled in the source program. When this process is completed, the 
assembled program is displayed on the screen. For an example of assembiy with 
default parameter values, we use the small sample program that we wrote. 
Figure 8 shows the appearance of the screen after the ASM command. 



Fignre 8. Appearance of the screen as your sample program is 

assembled. 


Using the Assembler 25 



Using Statements 30 and 40 as examples, the format of the assembled program is 
shown below. Note, however, that some of the spacing can be changed by the 
TAB directive. 


3002 


BE4437 30 REP LDX ABSX, Y 



Operand 

Op Code Mnemonic 
Label 

Statement Number 
Instruction 

Comment from previous 
line Starts here 
Address 


Figure 9. Normal (default) format of assembly listing as it appears 

nn the screen. 


The general form of the command shown at the beginning of the section shows 
how to override the default values of the parameters of the command. Ihese 
override selections are explained below. 


Location of Source Program 

You may specify the location of the source program as a named program on 
diskette. You must have previously stored the source program under that name, 
using the LIST command. In the general form of the ASM command, the source 
program on diskette has been given the extension .SRC. Extensions are optional. 


Where Assembly Listing Is To Be Stored 

The default value is the screen (tfE:). The other possibilities are the printei (#P.), 
the Program Recorder (#C:), and the disk drive (#D[n]:NAME f.LSTl). 


Where Object Program Is To Be Stored 

You may specify that the assembled program is to be stored directly on diskette, 
using any name (subject to the restrictions of DOS). In the general form of t i 
ASM command, the assembled program has been given the extension .OBJ. 
Extensions are optional. 

It is easy to become confused by names of programs when a program may exist 
in several related forms. To reduce the chance of confusion, we recommend 
using names that include identifying extensions, such as .SRC, .LST and .OBJ tor 
a source program, an assembly listing and an object program, respectively. 


Note that in the ASM command the source program must be in the edit text buf- 
fer or on a diskette in the disk drive. It can not be on a cassette in the ITogiam 
Recorder. The primary reason for this restriction is that the Assembler requires 
two passes of the source program and the Program Recorder is not controllable 
to permit two passes. However, you can assemble a source program i ecorded 




with your Program Recorder. First transfer the program from Program 
Recorder to the edit text buffer with the command: 

ENTERIC: (Follow the cassette-handling 

instructions in your Program 
Recorder Operator’s Manual.) 

The ASM command with no default parameters is illustrated in the example 
below: 

ASM#D:SOURCE,#P:,#D2:SEMBLED.OBJ S« 


The above command takes the source program that you had previously stored 
on diskette and called SOURCE, assembles it, lists the assembled form on the 
printer, and records on the diskette the machine code translation of the pro- 
gram (the object program). The object program is given the name 
“SEMBLED.OBJ.” Note that commands of this form störe the machine code on 
diskette, not in Computer RAM. 

To make a default selection, enter a comma, as in the following useful 
command: 

ASM,#P: «BHBa» 

The above command takes the source program from the default edit text buffer, 
assembles and lists it on the printer as before, and Stores the machine code 
object program directly into Computer RAM. 


DIRECTIVES 

(PSEUDO 

OPERATIONS) 


Directives are instructions to the Assembler. Directives do not, in general, pro- 
duce any assembled code, but they affect the way the Assembler assembles 
other instructions during the assembly process. Directives are also called pseudo 
operations or pseudo ops. 


Directives are identified by the Assembler by the at the beginning. The only 
exceptions are the LABEL = directive and the * = directive. 


A directive must have a line number, which it follows by at least two spaces. 
The directive LABEL = is an exception—there must be only one space before the 
label. 


OPT Directive 

This directive specifies an Option. There are four sets of options. These are: 


OPT NOLIST 


OPT LIST 

(this is the default condition) 

OPT NOOBJ 


OPT OBJ 

(this is the default condition) 

OPT NOERR 


OPT ERR 

(this is the default condition) 

OPT NOEJECT 


OPT IJECT 

(this is the default condition) 
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The second listed of each pair represents the Standard or default condition. 


100 . OPT NOLIST The effect of these directives is to omit from the listed 
(part of source form of the assembled program the lines between lines 
program) 100 and 200. (These line numbers are arbitrary.) 

200 . OPT LIST 


100 . OPT NOOOBJ 
(part of source 
program) 

200\ OPT OBJ 


Assembly is suppressed between lines 100 and 200. The 
effect of these directives is to omit from the object pro- 
gram code corresponding to the lines between lines 100 
and 200. Memory corresponding to these lines is skipped 
over, leaving a region of untouched bytes in the object 
program. (These line numbers are arbitrary.) 


100 . OPT NOERR The effect of these directives is to omit error messages 
(part of source for the assembled program lines between lines 100 
program) and 200. 

200 . OPT ERR 


100 . OPT NOEJECT The effect of these directives is to suppress, between 
(part of source lines 100 and 200, the 4-line page spacing that is 
program) normally inserted after every 56 lines of the listed form 

200 . OPT EJECT of the assembled program. 


More than one Option may appear on a line. Options are then separated by a 
comma, as follows: 

1000 . OPT NOLIST,NOOBJ 


Title and Page Directives 

10 . TITLE “name” 

20 . PAGE “optional message” 

We explain these directives together because they are intended to be used 
together to provide easily read information about the assembled program. 

These directives are most useful when the assembled program is listed on the 
printer. 

TITLE and PAGE allow you to divide your program listing into segments that 
bear messages written for your own convenience, much as you might add short 
explanatory notes to any complex material. 

The PAGE directive causes the printer to put out six blank lines (printers so 
equipped will execute a TOP OF FORM), followed by the messages you have 
given for TITLE and PAGE. This causes the messages to stand out somewhat 
from the rest of the assembled program listing. 

Usually there is only one TITLE directive, giving the program name and date, 
and different PAGE directives for giving different page messages. Then on 
listing the assembled program, the same TITLE message on every page would 
be followed by a different PAGE message. 

The blank lines that the PAGE directive produces on the 40-column ATARI 820 
Printer can be used to break up a long program into segments that can be 
mounted in a notebook. 



To remove a title, use the following form: 

1000 . TITLE “ ” 

The above directive removes titles after line 1000. 

The PAGE directive on its own causes a page break—the printer simply puts out 
a number of blank lines. 

Tab Directive 

10 . TAB nl,n2,n3 

The TAB directive sets the fields of the Statement as they appear when assem- 
bled and listed on the screen or the printer. Let us use the specific example of 
Statement 40 of the small sample program we previously used for illustration. It 
was written as follows: 

30 ... 

40 BEQ XEQ SAME PAGE 
50 ... 

Note that one space, rather than a tab, is used between each field. Using spaces 
rather than tabs lets you write longer programs, since the edit text buffer will 
not be filled up with the extra spaces that tabs would require. 

Compressing the program in this way makes it less easily readable than we 
might wish, but we can use the TAB directive to give us a more readable 
assembled Version. The form of the directive is 

lineno . TAB 10,15,20 
or, more generally, 

lineno . TAB numberI,number2,number3 

The previous example has a source program that was compressed in the above 
fashion. Note the difference between the spacing of the source listing and the 
assembled program. This is an example of the default TAB spacing. ' 

The effcct of the TAB directive of line xxx is confined to the appearance of lines 
following xxx when they are assembled and listed on the printer or screen. 

In the case of line 40, the appearance on the printer would be as shown below: 

3005 D0G4 40 BNE XEQ SAME PAGE 

-10-1 I 

-15—1 

- 20 — 

If the TAB directive is not used, then the appearance of the assembler line on the 
printer will be as shown below in the default mode: 

3005 D064 40 BNE XEQ, S 

AME PAGE 



-27— 1 

That is, the default setting corresponds to . TAB 12,17,27. 
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The appearance of this line on the screen will be different only because the 
screen has 38 characters positions, while the printer has 40. 

BYTE, DBYTE and WORD Directives 

100 . BYTE a,b,... ,n 
200 . BYTE “A,B,... N” 

300 . DBYTE a,b,... ,n 
400 .WORD a,b,... ,n 

These directives are similar in that they are used to insert data rather than 
instructions into the proper places in the program. Each directive is slightly 
different in the manner in which it inserts data. 

BYTE Directive 

The BYTE directive reserves a location (at least one) in memory. The directive 
increments the program counter to leave space in memory to be filled by Infor¬ 
mation recjuired by the program. The Operand supplies the data to go into that 
space. 

Examples: 

10 . 

20 .BYTE 34 
30 . 

Here, the Assembler assembles into successive locations the instruction of line 
10, then the decimal number 34, then the instruction of line 30. 

10 . 

20 . BYTE 34, 56,78 
30 . 

Here, the Assembler assembles into successive locations the instruction of line 
10, then the decimal numbers 34, 56 and 78, then the instruction of line 30. The 
Operand may be an expression more complex than the numbers used in the 
examples. The rules for writing and evaluating an expression are given in 
Appendix D. 

10 . 

20 . BYTE “ATARI” 

30 . 

Here, the Assembler assembles into successive locations the instruction of line 
10, then the (ATASCII code) hex numbers 41, 54, 41, 52 and 49, then the instruc¬ 
tion of line 30. 

DBYTE Directive 

The DBYTE directive reserves two locations for each expression in the Operand. 
The value of the expression is assembled with the high-order byte first (in the 
lower number location). For example: 

10 * = S4000 

20 .DBYTE ABS+ $3000 


When line 20 is assembled and the value of ABS+ $3000 is determined to be (say) 
$5123, $51 is put in location S4000 and $23 is put in location $4001. 








WORD Directive 

The WORD directive is the same as the DBYTE directive except that the value of 
thc expression is stored with the low-order byte first. 

For example: 

10 *=$4000 

20 .WORD ABS+ $3000 

When line 20 is assembled and the value of ABS + $3000 is determined, as before, 
to be S5123, $23 is put in location $4000 and $51 is put in location $4001. 


The WORD directive simplifies some programming since addresses in machine 
code are always given in the order low byte followed by high byte. Therefore, 
the WORD directive is useful, for example, in constructing a table of addresses. 

100 LABEL = expression 

The LABEL = directive is used to give a value to a label. Two examples appear in 
the sample program we used before. Statements 60 and 70 give values to ABSX 
and XEQ, as follows: 

60 ABSX = $3744 
70 XEQ= * +$60 

Since the Symbol that is given a value is a label, there must be only one space 
after the Statement number. The expression on the right cannot have a value 
great er than FFFF (hex). The rules for writing and evaluating an expression are 
given in Appendix 4. 

When the LABEL = directive is used to give a value to a label, the label can be 
used in an Operand, by itself, as in Statements 30 and 40 in thc sample program. 

A defined label may also appear as part of an expression. Our sample program 
does not contain an example, so we give one below in line 240. 

100 TAB1 = $3000 


240 TAB2 = TAB1 +$20 

When the program is assembled, TAB2.will be given thc value $3020. 

You should note that defining a label in this way gives the label a specific 
address; it does not define the contents of the address. In the example, above, 
TAB1 and TAB2 might be the location of two tables that contained the values of 
variables that your program recjuired. 

* = Directive 

100 * = expression 

We encountered the * = directive in the “getting started” commands, vvhere it 
is used to set the starting location of the assembled program. When the 
Assembler encounters the * = expression, it sets the program counter to thc 
value of the expression. 
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You write *= without the initial that the other directives have (except 
LABEL = ). Also, note that you write * = without any spaces between * and =. 

You should not confuse the * = directive with the LABEL = directive. The * in 
* = is not a label. Note, however, that the * = directive itself may have a label, as 
follows: 

200 GO * = expression 
500 JMP GO 

The Assembler will assemble Statement 500 as a jump to the value the program 
counter had BEFORE it was changed by line 200. 

The * = directive is useful for setting aside space needed by your program. For 
example, you will freq[uently want space reserved starting at a particular loca- 
tion. Use the following form: 

720 TABLE35 * = *+$24 
740 ... 

The effect of the directive is to reserve 24 locations immediately after TABLE35. 
Other parts of your code will not be assembled into these locations (unless you 
take pains to do so). Your program can use TABLE35 as an Operand and 
TABLE35 can be used as an element in an expression that your instructions 
evaluate in accessing the table. 

IF Directive 

900. IF expression @LABEL 


990 LABEL End of conditional assembly 

The IF directive permits conditional assembly of blocks of code. In the Illustra¬ 
tion above, all the code between lines 900 and 990 will be assembled if and only 
if the expression is equal to zero. If the expression is not equal to zero, the IF 
directive has no effect on assembly. 

The example given below shows how different parts of a source program may 
be omitted from assembly according to the value assigned to the LABEL in the IF 
directive. The source program is assembled with Z = 0 in one case and Z = 1 in 
another. With Z = 0, the instruetion TAX is assembled, and with Z = 1 the in- 
struction ASL A is assembled. Obviously, this kind of selective assembly can be 
extended indefinitely. 


SOURCE CODE 

0100 ;CONDITIONAL ASSEMBLY EXAMPLE 

0120 Z = 0 

0130 *=$5000 

0140 LDA = $45 

0150 . IF Z@ZNOTEQUAL0 

01G0 TAX ;THIS CODE ASSEMBLED IFF Z = 0 

0170 ZNOTEQUALO 

0180 . IF Z - l@ZNOTEQUALl 

0190 ASL A ;THIS CODE ASSEMBLED IFF Z = 1 

0200 ZNOTEQUAL1 

0210 INX ;THIS CODE ALWAYS ASSEMBLED 



ASSEMBLY LISTING (40-col. format) 

0100 KONDITIONAL ASSEMBLY E 
XAMPLE 

0000 0120 Z = 0 
0000 0130 * = $5000 
5000 A945 0140 LDA #$45 
5002 0150 . IF Z@ZNOTEQUA 
L0 

5002 AA 0160 TAX ; 

THIS CODE ASSEMBLED IFF Z = 0 
0170 ZNOTEQUALO 

5003 0180 . IF Z - l@ZNOTEQ 
UAL1 

0190 ASLA 
0200 ZNOTEQUAL1 
5003 E8 0210 INX ; 

THIS CODE ALWAYS ASSEMBLED 

0100 KONDITIONAL ASSEMBLY E 
XAMPLE 

0001 0120 Z = 1 
0000 0130 *= $5000 
5000 A945 0140 LDA #$45 
5002 0150 . IF Z@ZNOTEQUA 
L0 

0160 TAX ;THIS CODE ASSEMBL 
ED IFF Z = 0 

0170 ZNOTEQUALO 
5002 0180 . IF Z-l@ZNOTEQ 
UAL1 

5002 OA 0190 ASL A 
0200 ZNOTEQUAL1 

5003 E8 0210 INX ; 

THIS CODE ALWAYS ASSEMBLED 

END Directive 

1000 . END 

Every program should have one and only onc END directive. It teils the 
Assembler to stop assembling. It should come at the very end of your source 
program. Later, if you decide to add more Statements to your program, you 
should remove the old . END directive and place a new one at the new end of 
your source program. Failure to do so will result in your added source code not 
being assembled. This mistake is particularly easy to make when vou make 
your additions with the NUM command. It is not always essential to have an 
. END directive, but it is good practice. 
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PURPOSE OF 
DEBUGGER 


CALLING THE 
DEBUGGER 


DEBUG 

COMMANDS 


DEBUGGING 


Ihc Debugger allows you to follow the Operation of an object program in detail 
and to make minor changes in it. 

A knowledge of machine language is helpful when you use the debugger, but it 
is not essential. The Debugger is able to convert machine code into assembly 
language (disassemble), so you can make code alterations at particular memory 
locations. All numbers used by the Debugger, both in input and output, are hex- 
adecimal. 

The Debugger is called from the Editor by typing: 

BUG «BBEWI 

This produces on the screen: 

DEBUG 

[] 

The command to return to the Writer/Editor is: 


RETURN 


The debug commands are listed below. In the list, “mmmm” indicates that the 
form of the command may include memory address(es). The actual methods of 
specifying the memory address(es) and the default addresses are shown in the 
examples given later in this section. If you use the commands with no 
address (es), the Debugger assigns a default address (es): 


DR 

CR 

D or Dmmmm 

C or Cmmmm 
Mmmmm 
Vmmmm 


Display Registers 

Change Registers 

Display Memory 

Change Memory 
Move Memory 
Verify Memory 


L or Lmmmm 
A 

Tmmmm 


List Memory With Disassembly 

Assemble One Instruction Into Memory 
Trace Operation 


S or Smmmm 
Gmmmm 


Single-Step Operation 
Go (Execute Program) 


X 


Return to EDITOR 


Pressing the 


BREAK 


key halts certain operations. 


Debugging 35 




We now give several examples showing how to use the commands. In the 
examples, the lines ending with Ml are entered on the keyboard. The other 
lines show the response of the System, as displayed on the screen. 

DR Display Registers 
Example: 

EDIT 

bug mm 

DEBUG 


return 


A = BA X = 12 Y = 34 P = BO S = DF 
DEBUG 
[] 

The registers and contents are displayed as shown. A is the Accumulator, X and 
Y are the Index Registers, P is the Processor Status Register, and S is the Stack 
Pointer. 


CR Change Registers 
Example: 


EDIT 

BUG 


RETURN 


DEBUG 

CR <1,2,3,4,5 figil 

DEBUG 

[] 

The effect of the command above is to set the contents of the registers A, X, Y, P, 
and S to 1, 2, 3, 4 and 5. 

You can skip registers by using commas after the <. For example, 


RETURN 


sets the Stack Pointer to E2 and leaves the other registers unchanged. Registers 
are changed in order up to §|§||ggg. For example, 

cr<,34 mmmm 

sets the X Register to 34 and leaves the other registers unchanged. 

D or Dmmmm Display Memory 

Dmmmm, yyyy where yyyy is less than or equal to mmmm shows the contents 
of address mmmm. 

Example: 

DEBUG 

D5000,0 


5000 A9 
DEBUG 
[] 


This shows that address 5000 contains the number A9. 

If the second address (yyyy) is omitted, the contents of eight successive locations 
are shown. The process can be continued by typing D f-üfff-gS . 

Example: 

DEBUG 

D5000 

5000 A9 03 18 E5 F0 4C 23 91 
DEBUG 

D iS» 

5008 18 41 54 41 52 49 20 20 
DEBUG 
[] 


Dmmmm,yyyy where yyyy is greater than mmmm, shows the contents of 
addresses mmmm to yyyy. 

Example: 

DEBUG 

D5000,500F tHHH 


5000 A9 03 18 E5 F0 4C 23 91 
500B 18 41 54 41 52 49 20 20 
DEBUG 

[] 


The display can be stopped by pressing the BREAK key. 

C or Cmmmm Change Memory 

Cmmmm < yy changes the contents of address mmmm to yy. 


Example: 


DEBUG 

C5001 <23 mm 


DEBUG 

[] 


The efYect of the command is to put the number 23 in location 5001. A comma 
increments the location to be changed. 


Example: 


DEBUG 

C500H<21.EF — 


DEBUG 

C700B<31...87 —i 


DEBUG 

[] 


The first command puts 21 and EF in locations 500B and 500C, respectively. 
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The second command puts 34 and 87 in locations 700B and 700E respectively. 


You can conveniently use the C command in conjunction with the Display 
Memory command, and you need not enter the address a second time with the C 
command. The C command will default to the last specified address. 

Example: 

D5000 fSggESB 

5000 A0 03 18 E5 FO 4C 23 91 
C< AA,14 tS® 


RETURN : 


5000 AA 14 18 E5 F0 4C 23 91 

DEBUG 

[] 

Mmmmm Move Memory 

Mmmmm < yyyy,zzzz copies memory from yyyy to zzzz to memory starting 
at mmmm. Address mmmm must be less than yyyy or greater than zzzz. If the 
origin and destination blocks overlap, results may not be correct. 

Example: 

DEBUG 

M1230 < 5000,500F ÜBgSBI 

DEBUG 

[] 

The command copies the data in location 5000-500F to location 1230-123F. 

Vmmmm Verify Memory 

Vmmmm<yyyy,zzz compares memory yyyy to zzzz with memory starting at 
mmmm, and shows mismatches. 

Example: 

DEBUG 

v 7 ooo< 7100,7123 mmm 

DEBUG 

[] 

The command compared the contents of 7100-7123 with the contents of 
7000-7023. There were no mismatches. 

Mismatches would be shown as follows: 

7101 00 7001 22 
7105 18 7005 10 

L or Lmmmm List Memory With Disassembly 

This command allows you to look at any block of memory in disassembled 
form. 


Examples: 

L7000 HStlM List a screen page (20 lines of Code) starting at 

memory location 7000. Pressing the key 

during listing halts the listing. 


L 


RETURN 


This form of the command lists a screen page start¬ 
ing at the instruction last shown, plus 1. 


L7000, 0 
L7000, 7000 
L7000, G000 


RETURN 

RETURN 

RETURN 


These forms list the instructions at address 
7000 only. 


L345, 567 This form lists address 345 through 567. Only the 

last 20 instructions will actually be visible at the 
completion of the response of the System. 


The command Lmmmm differs from Dmmmm in that Lmmmm disassembles 
the contents of memory. 

Example: 

EDIT 

BUG Ql 


DEBUG 

L5000, 0 S® 

5000 A9 03 LDA #$03 

DEBUG 

[] 

This example shows that the Debugger examined the contents of memory 
address 5000 and disassembled A9 to LDA. Since A9 must have a one-byte 
Operand, the Debugger made the next byte (the contents of address 5001) the 
Operand. Therefore, although the debugger was only “asked” for the content of 
location 5000, it showed a certain amount of intelligence and replied by show- 
ing the instruction that started at address 5000. 

To illustrate this further, the number 03 corresponds to no machine code 
instruction, so the Debugger would interpret 03 as an illegal instruction, and 
alert you to a possible error, as shown below. 

Example: 

DEBUG 


RETURN 


5001, 03 ??? 

DEBUG 

However, if the first instruction you wrote was LDA $8A, then you would have 
obtained the following, apparently inconsistent, results while debugging: 

Example: 

DEBUG 

L5000, 00 A9 8A LDA #$8A 
DEBUG 

L5001, 0 8A TXA 
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Because the disassembler Starts disassembling from the first address you 
specify, you have to take care that the first address contains the first byte of a 
“real” instruction. 


A Assemble One Instruction Into Memory 

The DEBUGGER has a mini-assembler, that can assemble one assembly language 
instruction at a time. To enter the Assemble mode, type: 


RETURN 


Once in the Assemble mode, you stay there until you wish to return to 
DEBUGGER, which you may do by pressing (on an empty line). 

To assemble an instruction, first enter the address at which you wish to have 
the machine code inserted. The number that you enter will be interpreted as a 
hex address. Now type “ < ” followed by at least one space, then the instruction. 
You may omit an address if assembly is to be in successive locations. 

Example: 

EDIT 

BUG 1331 

DEBUG 
A SSI 
5001 <LDY $1234 

5001 AC3412 Computer Responds. 


RETURN ] 


5004 CB Computer Responds. 


| RETURN 


DEBUG 

[] 


Since the mini-assembler assembles only one instruction at a time, it cannot 
refer to another instruction. Therefore, it cannot interpret a label. Conse- 
quently, labels are not legal in the mini-assembler. 

You can use the directives BYTE, DBYTE, and WORD. 


Gmmmm Go (Execute Program) 

This command executes instructions starting at mmmm. For example: 

G7B00 Executes instructions starting at location 7B00. 

Execution continues indefinitely. Execution is 
stopped by pressing the iUffllü key (unless the pro¬ 
gram at 7B00 tricks or crashes the operating System). 


Tmmmm Trace Operation 

This command has the same effect as Gmmmm, except that aff er execution of 
each instruction the screen shows the instruction address, the instruction in 
machine code, the instruction in assembly language (disassembled by the 
debugger—not necessarily the same as you wrote it in assembly language) and 
the values of Registers A, X, Y, P and S. 


The execution stops at a BRK instruction (machine code 00) or when you press 
the ütfill key on the keyboard. 
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Example: 

DEBUG 

T5000 laauaw 


5000 

A9 

03 

LDA 

#$03 

> 

II 

O 

Co 

X = 02 

Y = 03 

P = 34 

S = 05 

5002 

18 


CLC 


A = 03 

X = 02 

Y = 03 

P = 34 

S = 05 

5003 

E5 

F0 

SBC 

$F0 

A = 03 

X = 02 

Y = 03 

P = 34 

c/a 

II 

O 

o\ 

5005 

4C 

23 71 

JMP 

$7123 

A = 03 

X = 02 

*< 

II 

o 

G3 

P = 34 

S = 05 

7123 

00 


BRK 


A = 03 

X = 02 

Y = 03 

P = 34 

S = 05 


DEBUG 

S or Smmnim Step Operation 

This command has the same effect as T or Tmmmm, except that only one 
instruction is executcd. To step through a program, type S ßmm repeatedly 
after the first command of Smmmm flaSliiiBjB 


To return to the Editor type: 

x gmaeaai 
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APPENDIX 1 


ERRORS 


When an error occurs, the console Speaker gives a short “beep” and the error 
number is displayed. 

Errors numbered less than 100 refer to the Assembler Editor cartridge, as 
follows: 

ERROR 

NUMBER 

1 . 

2 . 

3. 

4. 

5. 

6 . 

7. 

8 . 

9. 

10 . 

11 . 

12 . 

13. 

14. 

15. 

16. 

17. 

18. 

19. 

Errors 

Errors numbered more than 100 refer to the Operating System and the Disk 
Operating System. For a complete list of DOS errors, refer to the DOS manual. 

128 key pressed during an I/O Operation. 

130 A nonexistent device specified for I/O. 

132 The command is invalid for the device. 

136 EOF. End of file read has been reached. This error may occur when 
reading from cassette. 

137 A record was longer than 256 characters. 

138 The device specified in the command does not respond. Make sure 
the device is connected to the console and powered. 

139 The device specified in the command does not return an Acknowl- 
edge signal. 


The memory available is insufficient for the program to be assem- 
bled. 

For the command “DEL xx,yy” the number xx cannot be found. 
There is an error in specifying an address (mini-assembler). 

The file named cannot be loaded. 

Undefined label reference. 

Error in syntax of a Statement. 

Label defined more than once. 

Buffer overflow. 

There is no label or * before “ = ”. 

The value of an expression is greater than 255 where only one byte 
was required. 

A null string has been used where invalid. 

The address or address type specified is incorrect. 

Phase error. An inconsistent result has been found from Pass 1 to 
Pass 2. 

Undefined forward reference. 

Line is too large. 

Assembler does not recognize the source Statement. 

Line number is too large. 

LOMEM command was attempted after other command(s) or instruc- 
tion(s). LOMEM, if used, must be the first command. 

There is no starting address. 
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140 Serial bus input framing error. 

142 Serial bus data frame overrun. 

143 Serial data checksum error. 

144 Device done error. 

145 Diskette error: Read-after-write comparison failed. 

14G Function not implemented. 

162 Disk full. 

165 File name error. 
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APPENDIX 2 


ASSEMBLER MNEMONICS 

(Alphabetic List) 


ADC Add Memory to Accumulator with Carry 
AND AND Accumulator with Memory 

ASL Shift Left (Accumulator or Memory) 

BCC Branch if Carry Clear 

BCS Branch if Carry Set 

BEQ Branch if Result = Zero 

BIT Test Memory Against Accumulator 

BMI Branch if Minus Result 

BNE Branch if Result ^ Zero 

BPL Branch on Plus Result 

BRK Break 

BVC Branch if V Flag Clear 

BVS Branch if V Flag Set 

CLC Clear Carry Flag 

CLD Clear Decimal Mode Flag 

CLI Clear Interrupt Disable Flag (Enable Interrupt) 

CLV Clear V Flag 

CMP Compare Accumulator and Memory 

CPX Compare Register X and Memory 

CPY Compare Register Y and Memory 

DEC Decrement Memory 

DEX Decrement Register X 

DEY Decrement Register Y 

EOR Exclusive-OR Accumulator with Memory 

INC Increment Memory 

INX Increment Register X 

INY Increment Register Y 

JMP Jump to New Location 

JSR Jump to Subroutine 

LDA Load Accumulator 

LDX Load Register X 

LDY Load Register Y 

LSR Shift Right (Accumulator or Memory) 

NOP No Operation 

ORA OR Accumulator with Memory 

PHA Push Accumulator on Stack 

PHP Push Processor Status Register (P) onto Stack 

PLA Pull Accumulator from Stack 

PLP Pull Processor Status Register (P) from Stack 

ROL Rotate Left (Accumulator or Memory) 

ROR Rotate Right (Accumulator or Memory) 

RTI Return from Interrupt 

RTS Return from Subroutine 

SBC Subtract Memory from Accumulator with Borrow 

SEC Set Carry Flag 

SED Set Decimal Mode Flag 

SEI Set Interrupt Disable Flag (Disable Interrupt) 
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STA Store Accumulator 

STX Store Register X 

STY Store Register Y 

TAX Transfer Accumulator to Register X 

TAY Transfer Accumulator to Register Y 

TSX Transfer Register SP to Register X 
TXA Transfer Register X to Accumulator 

TXS Transfer Register X to Register SP 

TYA Transfer Register Y to Accumulator 
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APPENDIX 3 


SPECIAL SYMBOLS 


Below we give a list of special Symbols that have a restricted meaning to the 
Assembler. You should avoid using these Symbols as a matter of course. Most 
attcmpts to use these Symbols in any but their special sense will result in errors. 
They may be used, without their special meaning, in comments and in the 
operands of memory reservation directives. 


5 The semicolon is used to indicate the Start of a comment. Everything 
between the semicolon and RETURN appears in the listed form of the 
program and is ignored by the Assembler. When comments take more 
than one line, start each new line with a semicolon. 

# The ff sign is used as the first Symbol of an immediate Operand, as in 
LDX #24. 

$ The $ sign is used before numbers to signify that they are to be interpreted 

as hex numbers. For example, LDX #$34. 

* The asterisk is used to signify the value of the current location counter. For 
example, the instruction in line 50 gives the Symbol HERE a value equal to 
5 or more than the number in the current location counter: 

50 HERE = * + 5 


Example: 

18 *=$911 

19 RTS 

20 * = * + $F 

21 TAX 


When this example is assembled, line 18 causes the location counter to be $0911, 
RTS is placed in location $0911, line 20 causes the location counter to be 
increased from $0912 to $0921, and TAX is placed in $0921. This leaves 15 
empty bytes between the RTS and the TAX. 

The asterisk also signifies multiplication (see Appendix 6). The Assembler uses 
the syntax of the Statement to distinguish the two meanings of the asterisk. 

Register names: 

A Accumulator 
X X Register 
Y Y Register 
S Stack Pointer 
P Processor Status Register 
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TABLE OF HEX DIGITS WITH COKRESPONDING 
OP CODE MNEMONICS AND OPERANDS 
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APPENDIX 5 
EXPRESSIONS 


When an instruction or dirertive calls for a number in the Operand, the number 
may be given as an “expression,” the number used beini the value of the 
expression. An expression is really just a formula. 


fcxpressions are made up of operators and terms. Terms are either numbers or 
labels which stand for numbers. An expression containing a label term that 
does not have a numeric value will be flagged as an error. 


There are five operators; four are arithmetic, and one is logical. 

Addition is signified by the sign + 

Subtraction is signified by the' sign 
Multiplication is signified by * 

Division is signified by / 

Logical AND is signified by 


Expressions must not contain parentheses. 


Expressions are evaluated from left to right. 


Examples: 


100 

*=$90 + 1007 

200 

JMP 

3+2*25*4/5-3 

300 

JMP 

0097 

400 

JMP 

$0061 

100 

LDA 

#NUM1 + NUM2 


600 

LDA 

LABEL &> $00FF 

610 

STA 

$CC 

620 

LDA 

LABEL/256 

630 

STA 

$CD 


These instructions are equivalent. 


NUM1 and NUM2 must be defined some- 
where in the program. The instruction 
loads the Accumulator with the sum of 
the numbers in the locations NUM1 and 
NUM2. 

This yields the low Order byte of the value 
of LABEL. 

This yields the high Order of byte of the 
value of LABEL. 
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APPENDIX 6 


DIRECTIVES 


. OPT Operand 


. TITLE “NAME” 

. PAGE ‘MESSAGE” 

. TAB nl,n2,n3 

. BYTE a,b...n 
. BYTE “AB...N” 

. DBYTE a, b,...n 


. WORD a, b,...,n 


AB = Expression 


* = Expression 


. IF Expression 
. LABEL 

. END 


specifies an option. Operand can be LIST or NOLIST, 
OBJ or NOOBJ, ERRORS or NOERRORS, EJECT or 
NOEJECT. (Default options are LIST, OBJECT, ERRORS, 
and EJECT.) 

causes NAME to be printed at the top of each page. 

produces a blank space in the listing, then causes 
MESSAGE to be printed after NAME. 

Controls the spacing of the fields of Op Code 
Mnemonic, Operand, and Comment as they appear in 
the listing. 

places in successive memory locations the values of the 
expressions a, b, n (one byte for each value). 

places in successive memory locations the ATASCII 
values of A, B, ..., N. 

places in successive pairs of memory locations the 
values of the expressions a, b, ..., n (two bytes for each 
value, high byte first). 

places in successive pairs of memory locations the 
values of the expressions a, b,..., n (two bytes for each 
value, low byte first). 

makes the Label AB ecjual to the value of the expres- 
sion (up to FFFF hex). 

makes the Program Counter equal to the value of the 
expression (up to FFFF hex). 


assembles following code, up to . LABEL, if and only if 
expression evaluates to zero. 

indicates the end of the program to be assembled. 
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APPENDIX 7 


ATASCII CHARACTER SET 
AND HEXADECIMAL TO 
DECIMAL CONVERSION 
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* 

<<y 

v - <y 


w 


119 

77 

w 

120 

78 

X 

121 

79 

y 

122 

7A 

z 

123 

7B 

□ 

124 

7C 

1 

125 

7D 

□ 

126 

7E 

□ 

127 

7F 

n 

128 

80 

(inverse cha 
begin) 

129 

81 


130 

82 


131 

83 


132 

84 


133 

85 


134 

86 
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Notes: 

1. ATASCII Stands for ATARI ASCII. Letters and numbers have the same values as those in ASCII, but 
some of the special characters are different. 

2. Except as shown, characters from 128-255 are reverse colors of 1 to 127. 

3. Add 32 to upper case code to get lower case code for same letter. 

4. To get ATASCII code, teil Computer (direct mode) to PRINT ASC (“_”) Fill blank with letter, 

character, or number of code. Must use the quotes! 
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APPENDIX 8 


REFERENCES 


ATARI PUBLICATIONS 

Obtainable from your ATARI dealer, or ATARI Consumer Division, Customer 
Support, 1195 Borregas Avenue, Sunnyvale, CA 9408G 


ATARI 400™ Operator’s Manual C014768 

ATARI 800™ Operator’s Manual C014769 

ATARI 810™ Operator’s Manual CO14760 

ATARI 815™ Operator’s Manual C016377 

ATARI Disk Operating System II Reference Manual 
ATARI 410™ Operator’s Manual CO14810 


OTHER PUBLICATIONS 
6502, Programming Manual 

SYNERTEK, 3050 Coronado Drive, Santa Clara, CA 95051 or 
MOS Technology, 950 Rittenhouse Road, Norristown, PA 19401 

6502 Assembly Language Programming by Lance Leventhal 
Osborne/McGraw-Hill, 630 Bancroft Way, Berkeley, CA 94710 

Programming the 6502 by Rodney Zaks 
Sybex, 2020 Milvia Street, Berkeley, CA 94704 
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APPENDIX 9 

USING THE ASSEMBLER CARTRIDGE 

TO BEST ADVANTAGE 






IsstnMvUnlu a l dit °ft Cartl ’, idge j is desi ^ ned t0 su PP°rt intermediate-Ievel 
S u edC ataIt’" development. It is good enough in this function to 

be used by ATARI s own programmers for some Software development. 

SfwarJ d? le i iS pm ? rful and Ü can do a S reat deal, but it is not a Professional 
development System. It is not well suited for development of large 

vnnS gUagC pr ° gFam ®- A g° od ru le of thumb is: take the amount of RAM 
you have m your System and divide by ten to find the langest amount of obiect 
code you can comfortably develop with this cartridge. Thus, an ATARI Personal 
Computer System with 16K of RAM can be used to develop obiect code 
I ogiams up to about 1G00 bytes in size. Of course, you can streich your 
memoryby ehminatmg all explanatory comments and using very short labels 
Thjs wjl allow you to fl, in much more Code, bu, i, will „fake your prog^Si 
difficult to revise at a later time. ^ & 

?»Z,Z 0m T nd r i0n u that , thiS cartrid ge is best used to develop machine 
language subroutines that enhance the speed and power of BASIC programs 

^iTmach n i gUagC COmplements 1 BASIC vei T well; the combination o/ßASIC 
id machme language is extremely powerful. You can unleash almost all of the 

c: r hisfusrBAsl?tr Per rf computer system with ^ ^n° a ;r 

you should use BASIC for most of yoiu' programming; it is easy to write and 

•inDli£fio°ns S !f OU C l 1Se a f embly lai ?S ua S e on] y w hen necessary. There are five 
apphcations of machme language that are particularly appropriate: 




Io provide certain special logical 
BASIC 


operations not readily available from 


To generate special sound effects that BASIC is too slow to generate 

• To generate high-speed graphics and animation 

• To utilize the interrupt capabilities of the machine 


To accomplish high-speed complex logical calculations and manipulations 

Most of these apphcations are situations that call for high speed; in general the 
pnmary advantage of machine language is its higher speed. Machine languaee 

thousfnd a ?° Ut tC f n ! ime ; S / aSt f r than BASIC and in spedal cases, can be up trfa 
fin°.w d T S f f ter -, We do not recommend using machine language for 
floatmg point anthmetic or for I/O to and from peripherals (except the screen) 

ÄS use machine language only when its speed advantages 
t gh the difficulties of programming in assembly language. 

, USe ° f aSS6mbly language rcc l u ires a thorough knowledge of the 
»TT a , nd ° peratm f s - ystem of host machine. Unfortunatelv, the ATARI 
ersonal Computer System is far too complex to cover adeduately in a brief 
appendix. We therefore provide four commented sample programs which 
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show how to execute some of the most commonly used functions. These 
programs are meant only for demonstration purposes; they certainly do not 
exercise the full power of the machine. You may wish to enhance them, adding 
whatever features you desire. In this way you will learn more about the ATARI 
Personal Computer System. 


All four programs have been written to reside on page 6 of'memory. These 256 
bytes have been reserved for your use. On page zero, only 7 bytes have been 
reserved for your use by the BASIC cartridge; they are locations $CB through 
$D1 (203 through 209). Locations $D4 and $D5 (212 and 213) are also usable; they 
are used to return parameters from machine language routines to BASIC 
through the USR function. Furthermore, locations $D6 through $F1 are used 
only by the floating point package; you may use them from BASIC USR calls if 
you do not mind having them altered every time an arithmetic Operation is 
performed. If your program runs only with the Assembler Editor cartridge and 
not the BASIC cartridge you may use zero page locations $B0 through $CF. You 
will have to be very sparing in your use of page zero locations, as nine safe 
locations will not take you far. It is not wise to usurp other locations on page 
zero, as they are used by the operating System and BASIC; there is no way to 
know if you thereby Sabotage some vital function and crash the System until it 
is too late. For the moment, we recommend that you limit yourself to programs 
that fit onto page 6 and use less than 9 bytes of page zero. The four sample 
programs meet that restriction; later we will show you how to make larger 
programs with BASIC. 


Our first sample program is very simple: it takes two 16-bit numbers, exclusive 
OR’s them together, and returns the resulting 16-bit number to BASIC. It is only 
17 bytes long and uses only 4 bytes of page zero. We will use it as a vehicle to 
show you the rudiments of interfacing machine language to BASIC. Here's how: 
First, type in the program with the Assembler Editor cartridge in place. Make 
sure that you have typed it in properly by assembling the program (the 
command ASM) and verifying that no errors are flagged to you. If it squawks 
unpleasantly, you have offended its delicate sensitivities; note the line number 
where the error occurred (CONTROL-1 is a handy way to stop the listing so you 
can see what happened). Then list the offending line and correct the typo. You 
may rest assured that the program as we list it will indeed assemble without 
errors; if you type it in exactly as listed it will work fine. Now assemble the 
program with the object code going to your nonvolatile storage medium (either 
diskette or cassette). If you have a disk drive, type in: 

ASM„#D:EXCLOR.OBJ 
If you have a Program Recorder, type in: 

ASM„#C: 

Follow normal procedures for using these devices. After the object code is 
stored to your diskette or cassette, open the cartridge slot cover and replace the 
Assembler Editor cartridge with the BASIC cartridge. Close the cover and when 
you see the READY prompt, load the program from diskette or cassette tape into 
RAM. 


If you have a diskette, type DOS to call DOS, then type L to load a binary file. 
When it asks what file to load, respond with: 


EXCLOR.OBJ HSai 


Whcn it returns the SELECT ITEM oromnt tw,e r 

you have a cassette tvne in n n n , /?, B to return to BASIC. If 


?PEEK(1536) 




A = USR(1536, 1, 3): ?A 


RETURN 


S^rSTeatab 2 IfT"' 1 by P T Kng ,he ™ lue 2 ’ be “ use 1 exclusive 
togetnei. They must be integers between 0 and 65535. 

SKS=£^äSS2 

the program with the Assembler VrVt ^ C , Same P roce dure as before, enter 
cassettefsave and In JT" ä «\ asse f bte “ <o the diskette or 

the program with: ’ °“ d 2 nlathl ™ hmguage Code. Then run 

A = USR(1536, 50, 10, 50, 200) 

‘short'TtST is tu d ed , up and you wm h “ r ■ 

with different values of the last f P ateau t dn d a long decay. Experiment 

generated cWe 'tVT'“ ” bo 

(1536) or the program will almost surely crash S P aramcter 

mmms 

GR. 19: A = USR(1536) ilta 

still be intact and usable. X 1 * Ö 832 key ’ the P r °« r am will 
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The last sample program demonstrates a very useful capability of the ATARI 
Personal Computer System—the display list interrupt. Perhaps you have heen itch- 
ing to have more than tive colors on the screen. With display list interrupts you 
can have up to 128 colors. Here’s the idea behind it: the ATARI display System 
uses a display list and display memory. The display list is a sequence of instruc- 
tions that teil the Computer what graphics format to use in putting Information 
onto the screen. The display memory is the Information going onto the screen. 
The address of the beginning of the display list can be found in locations 560 and 
561 (decimal).The address of the beginning of the display memory can be found 
in locations 88 and 89 (decimal). Wondrous things can be done by changing the 
display list; this program demonstrates only one of the capabilities of the 
display list System. If bit 7 of a display list instruction is set (equal to 1), then the 
Computer will generate a non-maskablc interrupt for the 6502 when it en- 
counters that display list instruction. 

If we place an interrupt routine which changes the color values in the color 
registers, the color on the screen will be changed each time a display list inter¬ 
rupt is encountered. This program consists of two parts: an initializing routine 
which sets up the display list interrupt vectors, sets all of the display list instruc- 
tions to generate display list interrupts, and lastly, enables the display list inter¬ 
rupts. The second routine actually Services the display list interrupts by chang¬ 
ing the color value in the color registers every time it is called. This routine is 
designed to operate in GRAPHICS 5 mode; it will put all 128 colors onto the 
screen. (Is that enough for you?) To see it in action, follow the familiär pro- 
cedure for entering, assembling, saving, and loading the program. Then key in 
the following BASIC immediate instruction: 

GR. 5: FOR 1= 0 TO 3: COLOR I: FORJ = 20*I TO 20*1 + 19: PLOTJ, 3: 

DRAWTOJ, 39: NEXTJ: NEXT I: A = USR(1536) 

We hope that these four sample programs have given you a clearer idea of how 
your ATARI Assembler Editor cartridge might be useful. There are some more 
advanced techniques for getting even more use out of your cartridge. The first 
problem many programmers encounter arises when they attempt to write a 
program larger than 256 bytes long. It will no longer fit onto page 6 and the pro- 
grammer must find a new place to put the program. The problem is made 
worse by the fact that the Operating System and BASIC use memory all over the 
address space. The programmer will have a hard time finding a safe place in 
memory where the machine language routine will not be wiped out by BASIC 
or the Operating System. There are a number of Solutions to this problem; each 
solution has advantages and disadvantages. We recommend the following ap- 
proach, which is difficult to understand but is also the most useful and safest 
route. What we are going to do is störe the machine language program inside a 
BASIC program and then touch it up so that it will run from anywhere in 
memory. 

We begin by writing an assembly language program with the Assembler Editor 
cartridge. Originate the program near the top of your available memory. For ex- 
ample, if you have 2K of object code and a 16K machine, originate the program 
at the 12K boundary with the directive 1 * =$3000’. This leaves 4K of space—2K 
for your program, 1K for a GRAPHICS mode 0 display, and 1K of extra space for 
good measure. Now go through the procedure of assembling the object Code to 
diskette or cassette, changing the Cartridges, and loading the object code into 
memory. Calculate the decimal addresses of the beginning and end of your ob¬ 
ject code. Let us say that your program is 2179 bytes long. It begins at $3000 or 
12288 decimal, so the last byte is at 14466. Print PEEK(12288) and PEEK(14466) to 
verify that these addresses really do contain the first and last bytes of your pro¬ 
gram. Remember, the Computer will print the results in decimal, not hex- 
adecimal, so you will have to eonvert in your head or with the Computer. 


Now start writing a BASIC program, begin with: 


2 DIM E$(2179) 


Then add this subroutine (which you can delete later): 

25000 A=90*J + 1:B = A + 89:IF B>LIMIT THEN B = LIMIT:?“LAST LINE” 
25010?J + 5;“E$(”;A;“,”,B,”) = ”;CHR$(34); 

25020 FOR I = A TO B:?“ HÜI El ”:CHR$fPEEK)I + C))::NEXT I 
25030 ?CHR$(34)J=J+1:RETURN 


Here the ; i symbol means that you press the escapc key twice. Now type 

in the following direct commands: 


j=ohb 

C = 12287 
LIMIT = 2179 


RETURN 


RETURN 


The value of C is the address of the byte before the first byte of your program. 
The value of LIMIT is the length of your object program. Now type GOSUB 

25ooo mm- 


The Computer will print a BASIC line onto the screen. It will look very 
stränge—all sorts of Strange characters inside a string. They are the screen 
representation of your object code. To make this line part of your BASIC prgram 
simply move the Cursor up to the line and press §j||||lggjf. You might reassure 
yourself that you were successful by entering: 


LIST 5 M3 


and verifying that line 5 really did go in. Now type GOSUB 25000 ||§ again 

and another line will be printed. Enter this one the same way as before. 
Continue this process of printing and entering lines until the entire object 
program has been encoded inside BASIC Statements. You will know you have 
reached this point when the Computer prints “LAST LINE” onto the screen. 


There is one possible hitch with this process. If you have a hex code of $22 
(decimal value 34) anywhere in your code it will be put onto the screen as a 
double quotation mark. This will confuse the BASIC Interpreter, which will 
give you a syntax error when you try to enter the line. If this happens, carefully 
count which byte is the offender and write down the index of the array which 
should contain the double quotation mark. Then go back and replace the 
offending quotation mark with a blank space; that will keep the BASIC 
interpreter happy. Make note of all such occurrences. When you are done 
entering the characters, type in a few more lines like: 


30 E$(292, 292) = CHR$(34) 


This line puts the double quotation mark into the 292nd array element by brüte 
force. It should come immediately after the lines that declare the string. You 
should have a line similar to this for each instance of the double quotation mark. 
Make sure that you have counted properly and put the double quotation marks 
into the right places. 


Now your object program is a part of the BASIC program. You can SAVE and 
LOAD the BASIC program and the object program will be saved and loaded 
along with it—a great convenience. You can run the object program by running 
the BASIC program and then executing the command: 
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A = USR(ADR(E$)) 


But there is still another possible hitch. The 6502 machine language code is not 
fully relocatable; any absolute memory references to the program are certain to 
fail. For example, suppose your program has a jump-to-subroutine (JSR) 
instruction that refers to a subroutine within the object code. This instruction 
would teil it to jump to a specific address. Unfortunately, your program has no 
way of knowing at what specific address that subroutine is stored and thus will 
almost certainly jump to the wrong address. The problem arises from the fact 
that BASIC might move your object program almost anywhere in memory. 

There are several Solutions to this problem. The simplest solution is to write 
fully relocatable code; that is, code with no JMP’s, no JSR’s and no data tables 
enclosed within it. Put all data tables and subroutines onto page 6. If you still 
need more space, put very large data tables into the BASIC string and point to 
them indirectly. Replace long JMP’s with a bücket brigade of branch 
instructions. These technicjues should allow you to write large machine 
language programs. 


Example 1. 

10 ; 

20 ; ROUTINE EXCLOR 

30 ; PERFORMS EXCLUSIVE OR OPERATION ON 

40 ; TWO BYTES PASSED THROUGH THE STACK 

50 ; PASSES RESULTS DIRECTLY THROUGH USR FUNCTION 


0000 


80 


* — 

$0600 


oocc 


90 

TEMPL 

= 

$CC 

TEMPORARY HOLDING LOCATION 

00CD 


0100 

TEMPH 

= 

$CD 

TEMPORARY HOLDING LOCATION 

00D4 


0110 

RESLTL 

= 

$D4 

ADDRESS FOR PASSING RESULTS 

00D5 


0120 

RESLTH 

= 

$D5 

ADDRESS FOR PASSING HIGH RESULT 

0600 

68 

0130 

EXCLOR 

PLA 



0601 

68 

0140 


PLA 



0602 

85CD 

0150 


STA 

TEMPH 

SAVE HIGH BYTE 

0604 

68 

0160 


PLA 



0605 

85CC 

0170 


STA 

TEMPL 

SAVE LOW BYTE 

0607 

68 

0180 


PLA 



0608 

45CD 

0190 


EOR 

TEMPH 

PERFORM HIGH EXCLUSIVE OR 

060A 

85D5 

0200 


STA 

RESLTH 

STORE RESULT 

060C 

68 

0210 


PLA 



060D 

45 CC 

0220 


EOR 

TEMPL 

PERFORM LOW EXCLUSIVE OR 

060F 

85D4 

0230 


STA 

RESLTL 

STORE RESULT 

0611 

60 

0240 


RTS 


WHAT COULD BE SIMPLER? 

0612 


0250 


.END 




Example 2. 

10 ; 

20 ; ROUTINE NOTE 

30 ; GENERATES NOTES WITH CONTROLLABLE ATTACK AND DECAY 

40 ; TIMES 

50 ; CALL FROM BASIC WITH COMMAND: 

60 ; A = USR(1536, F, A, P, D) 
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70 

80 

90 

0100 

0110 

0120 

0130 


0000 


0140 

D200 


0150 

D201 


0160 

oocc 


0170 

00CD 


0180 

00CE 


0190 

0600 

68 

0200 

0601 

68 

0210 

0602 

68 

0220 

0603 

8D00D2 

0230 

0606 

68 

0240 

0607 

85CC 

0250 

0608 

68 

0260 

060A 

68 

0270 

060B 

68 

0280 

060C 

85CD 

0290 

060E 

68 

0300 

060F 

68 

0310 

0610 

85CE 

0320 


Xr 0330 


0340 

0350 


0612 

A9A0 

0360 

0614 

8D01D2 

0370 

0617 

A6CC 

0380 

0619 

204106 

0390 

061C 

18 

0400 

061D 

6901 

0410 

061F 

C9B0 

0420 

0621 

D0F1 

0430 

J 


0440 



0450 



0460 

0623 

A90E 

0470 

0625 

A6CD 

0480 

0627 

204106 

0490 

062A 

38 

0500 

062B 

E901 

0510 

062D 

D0F6 

0520 



0530 



0540 



0550 

062F 

A9AF 

0560 

0631 

8D01D2 

0570 

0634 

A6CE 

0580 

0636 

204106 

0590 


WHERE 

F IS THE FREQUENCY 
A IS THE ATTACK TIME 
P IS THE PEAK TIME 
D IS THE DECAY TIME 

ALL TIMES GIVEN IN UNITS OF 


* = 

$0600 

AUDF1 

$D200 

AUDC1 

$D201 

ATTACK 

$CC 

PEAK 

$CD 

DECAY 

NOTE PLA 

PLA 
PLA 

$CE 

STA 

PLA 

AUDF1 

STA 

PLA 

PLA 

PLA 

ATTACK 

STA 

PLA 

PLA 

PEAK 

STA 

DECAY 

3 

; ATTACK LOOP 

5 

LDA 

#$A0 

ATLOOP STA 

AUDC1 

LDX 

ATTACK 

JSR 

CLC 

DELAY 

ADC 

#$01 

CMP 

#$BO 

BNE 

ATLOOP 

; PEAK LOOP 

3 

LDA 

#$OE 

PKLOOP LDX 

PEAK 

JSR 

SEC 

DELAY 

SBC 

#$01 

BNE 

PKLOOP 

3 

; DECAY LOOP 

3 

LDA 

#$AF 

DCLOOP STA 

AUDC1 

LDX 

DECAY 

JSR 

DELAY 


1.6 MILLISECONDS 

AUDIO FREQUENCY REGISTER 
AUDIO CONTROL REGISTER 
ATTACK TIME 
PEAK OR PLATEAU TIME 
DECAY TIME 


SET FREQUENCY 
SET ATTACK TIME 


SET PEAK TIME 


SET DECAY TIME 


START WITH ZERO VOLUME 
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0639 

38 

0600 

SEC 


063A 

E901 

0610 

SBC 

#$01 

063C 

C99F 

0620 

CMP 

#$9F 

063E 

D0F1 

0630 

BNE 

DCLOOP 

0640 

60 

0640 

RTS 




0650 

> 


0641 

A013 

0660 

DELAY LDY 

#$13 

0643 

88 

0670 

DELAY2 DEY 


0644 

DOFD 

0680 

BNE 

DELAY2 

0646 

CA 

0690 

DEX 


0647 

D0F8 

0700 

BNE 

DELAY 

0649 

60 

0710 

RTS 


064A 


0720 

.END 


Example 3. 






10 

5 




20 

5 

; ROUTINE SPLAY 




40 

; PUTS A PRETTY DISPLAY ONTO THE SCREEN 



50 

; CALL FROM BASIC WITH THE FOLLOWING COMMANDS 



60 

; GR. 19: A = USR(1536) 



70 

; EXIT PROGRAM WITH @ | 



80 

5 




90 

> 




0100 

* _ 

$0600 

oocc 


0110 

TEMP 

$CC TEMPORARY LOCATION 

00CD 


0120 

XLOC 

$CD HORIZONTAL POSITION OF PIXEL 

OOCE 


0130 

YLOC 

$CE VERTICAL POSITION OF PIXEL 

OOCF 


0140 

DIST 

$CF DIST. OF PIXEL FROM SCREEN CENTER 

00 DO 


0150 

PHASE 

$D0 COLOR PHASE 

00D1 


0160 

COLOR 

$D1 COLOR CHOICE 

0058 


0170 

SAVMSC 

$58 POINTER TO BEG. OF DISPLAY MEMORY 

02C4 


0180 

COLORO 

$02C4 LOCATION OF COLOR REGISTERS 

D20A 


0190 

RANDOM 

$D20A HARDWARE RANDOM NUMBER LOCATION 

0600 

68 

0200 

SPLAY PLA 

POP A ZERO FROM STACK 

0601 

85 DO 

0210 

STA 

PHASE STORE IT IN PHASE 

0603 

AA 

0220 

TAX 

SET COUNTER 



0230 

y 




0240 

; THIS IS THE MAIN PROGRAM LOOP 



0250 

; FIRST WE RANDOMLY CHOOSE THE SCREEN LOC. TO MODIFY 



0260 

; SCREEN IS 40 PIXELS HORIZONTALLY BY 24 PIXELS VERTICALLY 



0270 

; WITH 4 HORIZONTALLY ADJACENT PIXELS PER BYTE 



0280 

; HENCE THERE ARE 10 BYTES PER HORIZONTAL ROW 



0290 

; AND 24 ROWS FOR A TOTAL OF 240 BYTES 



0300 

; TO REPRESENT THE SCREEN 



0310 

y 




0320 

y 




0330 

y 


0604 

AD0AD2 

0340 

BEGIN LDA 

RANDOM GET A RANDOM NUMBER 

0607 

290F 

0350 

AND 

#$0F MASK OFF LOWER NYBBLE 

0609 

C90A 

0360 

CMP 

#$0A MUST BE SMALLER THAN 10 

060B 

B0F7 

0370 

BCS 

BEGIN IF NOT, TRY AGAIN 
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060D 
060F 
0610 
0612 
0614 
0616 
0617 
0619 
061B 
06 IE 
0620 
0622 
0624 
0626 
0627 
0629 
062B 
062D 
062E 


85CD 

38 

E905 

1005 

49FF 

18 

6901 
85CF 
AD0AD2 
291F 
C918 
B0F7 
85 CE 
38 

E90C 

1005 

49FF 

18 

6901 


0630 18 

0631 65CF 
0633 65D0 


0635 291F 

0637 4A 
0638 4A 
0639 4A 
063A 85 Dl 


063C AD0AD2 
063F 2903 

0641 A8 
0642 F007 


0644 06D1 

0646 06D1 

0648 88 

0649 D0F9 


064B A5CE 
064D 0A 


0380 
0390 
0400 
0410 
0420 
0430 
0440 
0450 
l 0460 
0470 
0480 
0490 
0500 
0510 
0520 
0530 
0540 
0550 
0560 
0570 
0580 
0590 
0600 
0610 
0620 
0630 
0640 
0650 
0660 
0670 
0680 
0690 
0700 
0710 
0720 
0730 
0740 
0750 
0760 
0770 
0780 
0790 
0800 
0810 
0820 
0830 
0840 
0850 
0860 
0870 
0880 
0890 ; 

0900 


STA 

SEC 

SBC 

BPL 

EOR 

CLC 

ADC 

XA STA 

TRYAGN LDA 
AND 
CMP 
BCS 
STA 
SEC 
SBC 
BPL 
EOR 
CLC 
ADC 


XLOC STORE THE RESULT 

#$0o GET X-DISTANCE FROM CENTER 

XA IS IT POSITIVE OR NEGATIVE? 

*$ FF IF NEGATIVE, MAKE IT POSITIVE 

#$01 

DIST SAVE THE ABSOLUTE VALUE 

RANDOM GET ANOTHER RANDOM NUMBER 
■^IF MASK OFF LOWER 5 BITS 
#$18 MUST BE SM ALLER THAN 24 

TRYAGN (BECAUSE THERE ARE ONLY 24 ROWS) 
YLOC STORE THE RESULT 

^0C GET Y-DIST FROM CENTER OF SCREEN 

IS IT POSITIVE OR NEGATIVE 3 
*$FF IF NEGATIVE, MAKE IT POSITIVE 


5 

; NOW CALCULATE THE COLOR TO PUT INTO THIS POSITION 
XB CLC 

Anr T ° TAL ° IST FR ° M CENTER OE SCREEN 

ADC PHASE COLOR PHASE OFFSET 

: BITS 3 AND 4 NOW GIVE THE COLOR TO USE 

y 

AND #$1F MASK OUT BITS 5, 6, AND 7 
LSR A 
LSR A 

LSR A SHIFT OFF BITS 0, 1, AND 2 

STA COLOR STORE RIGHT-JUSTIFIED RESULT 

; NOW WE MUST DETERMINE WHICH OF THE 4 PIXEI S 
; IN THE BYTE GET THE COLOR 

LDA random 

AND #$03 GET A RANDOM NO. BETWEEN 0 AND 3 
USE IT AS A COUNTER 
BE Q NOSHFT SKIP AHEAD IF IT IS 0 

y 

; SHIF T OVER TWICE FOR EACH STEP IN Y 

J 

SHFTLP ASL COLOR 
ASL COLOR 
DEY 

BNE SHFTLP 


! sw1re E MUST CALCULATE WHERE IN MEMORY TO PUT OUR 

NOSHFT LDA YLOC GET VERTICAL POSITION 

ASL A YLOC *2 
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064E 

85CC 

0910 

STA 

TEMP SAVE IT FOR A FEW MICROSECONDS 

0650 

0A 

0920 

ASL 

A 

0651 

OA 

0930 

ASL 

A YLOC*8 

0652 

65 CC 

0940 

ADC 

TEMP ADD IN YLOC*2 



0950 

3 




0960 

; RESULT IN ACCUMULATOR IS YLOC*10 



0970 

; REMEMBER, THERE ARE TEN BYTES PER SCREEN ROW 



0980 

3 


0654 

65CD 

0990 

ADC 

XLOC 



1000 

3 




1010 

; RESULT IS MEMORY LOCATION OF DESIRED PIXEL GROUP 

0656 

A8 

1020 

TAY 


0657 

A5D1 

1030 

LDA 

COLOR GET COLOR BYTE 

0659 

9158 

1040 

STA 

(SAVMSC)jY PUT IT ONTO THE SCREEN 

065B 

CA 

1050 

DEX 

WE SHALL PUT 254 MORE SQUARES 

065C 

D0A6 

1060 

BNE 

BEGIN ONTO THE SCREEN 



1070 

3 




1080 

; END OF MAIN INNER LOOP 



1090 

3 


065E 

C6D0 

1100 

DEC 

PHASE STEP COLOR PHASE FOR EXPLOSION 

0660 

A5D0 

1110 

LDA 

PHASE 

0662 

291F 

1120 

AND 

#$1F EVERY 32 PHASE STEPS 

0664 

D09E 

1130 

BNE 

BEGIN WE CHANGE COLOR REGISTERS 



1140 

; THIS SECTION USES BITS 5 AND 6 OF PHASE 



1150 

; TO CHOOSE WHICH COLOR REGISTER TO MODIFY 



1160 

3 


0666 

A5D0 

1170 

LDA 

PHASE 

0668 

4A 

1180 

LSR 

A 

0669 

4A 

1190 

LSR 

A 

066A 

4A 

1200 

LSR 

A 

066B 

4A 

1210 

LSR 

A 

066C 

4A 

1220 

LSR 

A 

066D 

2903 

1230 

AND 

#$03 

066F 

AA 

1240 

TAX 




1250 

3 


0670 

AD0AD2 

1260 

LDA 

RANDOM CHOOSE A RANDOM COLOR 

0673 

9DC402 

1270 

STA 

COLORO,X PUT NEW COLOR INTO COLOR REG. 

0676 

4C0406 

1280 

JMP 

BEGIN START ALL OVER 

0679 


1290 

.END 


Example 4. 






10 





20 

: KATHY’S COLOR PALETTE 



30 

; PUTS ALL 128 COLORS ONTO THE SCREEN 



40 

; CALL FROM BASIC WITH THE FOLLOWING COMMANDS: 



50 

; GR. 5 




60 

; FORI = 0 TO 3: COLOR I: FOR J = 20*1 TO 20*1 + 19: PLOT J, 3: 



65 

; DRAWTO J, 39: NEXT J: NEXT I 



70 

; A = USR(1536) 




80 

; BASIC IS STILL USABLE 



90 

; EXIT WITH SYSTEM RESET KEY 



0100 

3 
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0110 ; 


0000 


0120 


* _ 

$0600 


oocc 


0130 

POINT A 

= 

$CC 

POINTER TO DISPLAY LIST 

00CE 


0140 

COLCNT 

= 

$CE 

KEEPS TRACK OF COLOR WE ARE ON 

OOCF 


0150 

DECK 

= 

$CF 

BIT 0 KEEPS TRACK OF WHICH DECK 

0230 


0160 

DSLSTL 

= 

$0230 

O. S. DISPLAY LIST ADDRESS 

D40E 


0170 

NMIEN 

= 

$D40E 

NON-MASKABLE INTERRUPT ENABLE 

D40F 


0180 

NMIRES 

= 

$D40F 

NON-MASKABLE INTERRUPT RESET 

D40F 


0190 

NMIST 

= 

$D40F 

NON-MASKABLE INTERRUPT STATUS 

0200 


0200 

VDSLST 

= 

$0200 

DISPLAY LIST INTERRUPT VECTOR 

D01A 


0210 

COLBAK 

= 

$D01A 

BACKGROUND COLOR REGISTER 

D016 


0220 

COLPFO 

= 

$D016 

COLOR REGISTER #0 

D017 


0230 

COLPF1 

= 

$D017 

COLOR REGISTER #1 

D018 


0240 

COLPF2 

= 

$D018 

COLOR REGISTER #2 

D40A 


0250 

WSYNC 

= 

$D40A 

WAIT FOR HORIZONTAL SYNC 

0600 

68 

0260 

SETUP 

PLA 


CLEAN STACK 



0270 

5 






0280 

; SET UP POINTER ON PAGE ZERO 



0290 

y 




0601 

AD3002 

0300 


LDA 

DSLSTL 


0604 

85CC 

0310 


STA 

POINTA 


0606 

AD3102 

0320 


LDA 

DSLSTL+1 

0609 

85CD 

0330 


STA 

POINTA+ 1 



0340 

y 




060B 

A007 

0350 


LDY 

#$07 

POINT TO 3RD MODE BYTE 

060D 

A98A 

0360 


LDA 

#$8A 

NEW MODE BYTE 



0370 

5 






0380 

; STORE 16 DISPLAY LIST INTERRUPT MODE BYTES 



0390 

> 




060F 

9 ICC 

0400 

LOOP 1 

STA 

(POINTA), Y 

0611 

C8 

0410 


INY 



0612 

C017 

0420 


CPY 

#$17 


0614 

D0F9 

0430 


BNE 

LOOP1 




0440 

J 






0450 

; SKIP FOUR BLANK LINES 




0460 

y 




0616 

C8 

0470 


INY 



0617 

C8 

0480 


INY 



0618 

C8 

0490 


INY 



0619 

C8 

0500 


INY 





0510 

y 






0520 

; STORE 16 MORE DISPLAY LIST INTERRUPT MODE BYTES 



0530 

y 




061A 

91CC 

0540 

LOOP2 

STA 

(POINTA), Y 

06 IC 

C8 

0550 


INY 



061D 

C02B 

0560 


CPY 

#$2B 


061F 

D0F9 

0570 


BNE 

LOOP2 



0580 ; 

0590 ; SET UP DISPLAY LIST INTERRUPT VECTOR 

0600 ; 

0621 A950 0610 LDA #$50 

0623 8D0002 0620 STA VDSLST 

0626 A906 0630 LDA #$06 
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0628 

8D102 

0640 


STA 

VDSLST + 1 



0650 

J 




062B 

A900 

0660 


LDA 

#300 


062D 

85CE 

0670 


STA 

COLCNT 

INITIALIZE COLOR COUNTER 

062F 

85CF 

0680 


STA 

DECK 

INITIALIZE DECK COUNTER 

0631 

8D0FD4 

0690 


STA 

NMIRES 

RESET INTRPT. STATUS REGISTER 

0634 

AD0FD4 

0700 

WAIT 

LDA 

NMIST 

GET INTERRUPT STATUS REGISTER 

0637 

2940 

0710 


AND 

#$40 

HAS VERTICAL BLANK OCCURRED? 

0639 

F0F9 

0720 


beq 

WAIT 

NO, KEEP CHECKING 

063B 

AD0ED4 

0730 


LDA 

NMIEN 

YES, ENABLE DISPLAY LIST 

063E 

0980 

0740 


ORA 

#$80 


0640 

8D0ED4 

0750 


STA 

NMIEN 

THIS ENABLES DLI 

0643 

60 

0760 


RTS 


ALL DONE 



0770 

5 






0780 

; DISPLAY LIST INTERRUPT SERVICE ROUTINE 



0790 

> 




0644 


0800 


* _ 

$0650 


0650 

48 

0810 

DLISRV 

PHA 


SAVE ACCUMULATOR 

0651 

A5CE 

0820 


LDA 

COLCNT 

GET CURRENT COLOR 

0653 

18 

0830 


CLC 



0654 

6910 

0840 


ADC 

#$10 

NEXT COLOR 

0656 

85CE 

0850 


STA 

COLCNT 

SAVE IT 

0658 

D013 

0860 


BNE 

OVER 

END OF DECK? 



0870 

> 






0880 

; END OF DECK, BLACKEN SCREEN 



0890 

5 




065A 

8D0AD4 

0900 


STA 

WSYNC 

WAIT FOR NEXT SCAN LINE 

065D 

8D0AD0 

0910 


STA 

COLBAK 

BLACKEN ALL REGISTERS 

0660 

8D16D0 

0920 


STA 

COLPFO 


0663 

8D17D0 

0930 


STA 

COLPF1 


0669 

E6CF 

0940 


STA 

COLPF2 


066B 

68 

0950 


INC 

DECK 

NEXT DECK 

066C 

40 

0960 


PLA 


RESTORE ACCUMULATOR 



0970 


RTI 


DONE 



0980 

5 






0990 

; PUT OUT NEXT COLOR, WITH FOUR LUMINOSITIES 



1000 

5 




066D 

A5CF 

1010 

OVER 

LDA 

DECK 

UPPER OR LOWER DECK? 

066F 

2901 

1020 


AND 

#$01 

MASK OFF RELEVANT BIT 

0671 

0A 

1030 


ASL 

A 

SHIFT INTO HIGH LUMINOSITY 

0672 

OA 

1040 


ASL 

A 


0673 

OA 

1050 


ASL 

A 


0674 

05 CE 

1060 


ORA 

COLCNT 

MERGE WITH COLOR NYBBLE 

0676 

8D0AD4 

1070 


STA 

WSYNC 

WAIT FOR NEXT SCAN LINE 

0679 

8D1AD0 

1080 


STA 

COLBAK 

STORE COLOR 

067C 

6902 

1090 


ADC 

#$02 

NEXT HIGHER LUMINOSITY 

067E 

8D16D0 

1100 


STA 

COLPFO 

STORE COLOR 

0681 

6902 

1110 


ADC 

#$02 

NEXT HIGHER LUMINOSITY 

0683 

8D17D0 

1120 


STA 

COLPF1 

STORE COLOR 

0686 

6902 

1130 


ADC 

#$02 

NEXT HIGHER LUMINOSITY 

0688 

8D18D0 

1140 


STA 

COLPF2 

STORE COLOR 

068B 

68 

1150 


PLA 


RESTORE ACCUMULATOR 

068C 

40 

1160 


RTI 


DONE 
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QUICK REFERENCE: 
COMMANDS RECOGNIZED BY 
THE ASSEMBLER EDITOR 



na m- d * —Me' Bdtor Cartridge, 
interesting version is presented. ’ ar<? P resented - In m °st cases only the most useful or 


EDITOR 

NUMxx, yy 

RENxx, yy 


ofyy ldeS 3Ut ° Hne numberin g starting at xx in increments 
renumbers all Statements in increments of yy, starting 


DELxx, yy 
NEW 

FIND/SOUGHT/xx, yy, A 


REP/OLD/NEW/xx, yy, A 


LIST HP: 

PRINT ffP: 

ENTER NAME 


deletes Statement numbers xx through yy 
wipes out source program 

finds and displays all occurrences of the String SOUGHT 
between xx and yy ° 

replaces all occurrences between lines xx and yy of the string 
OLD with the strmg NEW ° 

lists source program to printer 

prints soui'ce program on printer 

retrieves source program from diskette 


SAVE #C: xxxx, yvyy 
LOAD ffC: 

ASSEMBLER 


saves data in addresses xxxx through yy yy to cassette 
retrieves data from cassette 


Reference 
Page No. 

15 

16 

15 

15 

16 

17 

19 


21 


21 

22 

22 


ASM#D: NAME. SRC, #P:, 


#D: NAME. OBJ 

retrieves source file called NAME. SRC on diskette, lis 
assembly listing to printer, and saves object program 
diskette under filename NAME. OBJ 


DEBUGGER 

DR 

CR < „x 
Dxxxx, yvyy 


displays 6502 registers A, X, Y, P, and S. 

puts an x into the Y-register. 

displays contents of addresses xxxx through yyyy 


25 


36 

36 

36 
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Cxxxx < yy 
Mxxxx < yyyy, zzzz 

Vxxxx < yyyy, zzzz 

Lxxxx 

A 

Gxxxx 

Txxxx 

Sxxxx 

X 


puts yy into address xxxx. 

copies memory block yyyy through zzzz into block starting 
at xxxx. 

compares memory block yyyy through zzzz with block 
starting at xxxx, displaying mismatches. 

disassembles memory starting at address xxxx. 

activates mini-assembler (no labels, one line at a time). 

runs object program at xxxx. 

trace; displays G502 registers while running object program 
at address xxxx at readable speed. 

single-steps object program at xxxx, displaying registers. 
return to EDIT mode 
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APPENDIX 11 


MODIFYING DOS I TO MAKE 
BINARY HEADERS COMPATIBLE WITH 
ASSEMBLER EDITOR CARTRIDGE 


The following assembly language program modifies four memory locations in 
“?f 1 t ° make bmai T Ble headers compatible with the Assembler Editor car- 
r r. a o T. hei T are tW ,° headers (each two bytes long)—one for SAVE and one for 
n- T ° cban S e tbe beader bytes from hex 8409 to hex FFFF for full com- 
patibility, type the following modification program. 


EDIT 


10 

20 

30 

40 

50 

60 

70 


LDA 

STA 

STA 

STA 

STA 


*=600 

#$FF 

$2441 

$2448 

$14BF 

$14C0 

END 


To assemble the modification program, type ASM and press 


RETURN 
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To run this program, you must be in DEBUG mode so, type the following. 

• Type BUG and press 

• Type G600 and press üfIPTlM . 

The screen will display: 



DOS I will now have header bytes that are fully compatible with the Assembler 
Editor cartridge. 

To change DOS I permanently on your diskette: 

1. Run the Modification Program. 

2. Type X to get out of BUG. 

3. Type DOS flifsliiMlCTI to enter DOS. 

4. Type H to write a fully compatible DOS on diskette. 

CHANGES AND LOCATIONS 

LOCATION PRESENT CONTENTS CHANGE TO 


DECIMAL 

HEX 

DECIMAL 

HEX 

DECIMAL 

HEX 


9281 

2441 

132 

84 

255 

FF 


9288 

2448 

9 

09 

255 

FF 

—LOAD 

5311 

14BF 

132 

84 

255 

FF 


5312 

14CO 

9 

09 

255 

FF 

—SAVE 


Instead of using the Modification Program, you could use BASIC to POKE 
decimal 255 into memory locations 9281, 9288, 5311, and 5312. After making 
the pokes, type DOS füafffi??! to display the DOS Menu. Type H to write 

the DOS modification onto diskette. 
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NOTES: 
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INSTRUCTION SET (OPERATION CODES) 


INDIRECT 
Inairecl Immed 


NON-INDEXED 
_ DIRECT 

Immed I Page 0 I Aosoiute Ads ,x 


TYPE QF ADDRESSING 
_ INDEXED 

DIRECT 


Operand ► 
Bytes ► 


- T-T— ---MISCELLANEOUS 

---- DIRE CT INDIRECT Register lA.X.Y.P. 

Abs ' Y 'ctwssins 

Mgg r ■ w j§r &T 


CONDITION 

FLAGS 

(Affected-*) 


na 


Iehi 


! >;■ ! 

i Laa l 

IE21I 




j lV'/M I 




|E3I 


ir.vMi 






IEH9 


Branch if N -0 

Note 2 

Branch il N-l 

Note 2 


Jump io Subroul. 


mai 


Return fr. Inlerrupl 


A Accumulator. or contents 
X, Y, P Registers X. Y, P, or conlonts 
SP Stack Pointer, or contents 

S Stack 

M Memory location (elloctive 

addressj, or contents 
M7 Bit 7 of M 

AV, V- Logical AND. OR. XOR 
P-Q P is copiod to Q, P uncPangod 


NOlES. Al 11*0 hMd of rach colunn un>r TVPr nF Annu-^i l r 

- 

’■ '"»« »«.«*«»» «cm»« --- -- ' «.•«W‘cc....."aic.tedc,,h.cl, cWw ^,„,, e ,, n „ a . CM9 . 

1 Bleccs Cl iOC and SBC m.y de cortainj II |l» D Fuj M Cd«*, cs.tlj;!,, 

4. C-0 wtter A er X or V < M. C-1 wh*n A or X or V * M. 

























